funzione DnsAcquireContextHandle_A (windns.h)

Il DnsAcquireContextHandle tipo di funzione acquisisce un handle di contesto a un set di credenziali. Come molte funzioni DNS, il DnsAcquireContextHandle tipo di funzione viene implementato in più forme per facilitare la codifica dei caratteri diversa. In base alla codifica dei caratteri interessata, usare una delle funzioni seguenti:

• DnsAcquireContextHandle_A (_A per la codifica ANSI)
• DnsAcquireContextHandle_W (_W per la codifica Unicode)

Sintassi

DNS_STATUS DnsAcquireContextHandle_A(
  [in]           DWORD   CredentialFlags,
  [in, optional] PVOID   Credentials,
  [out]          PHANDLE pContext
);

Parametri

[in] CredentialFlags

Flag che indica la codifica dei caratteri. Impostare su TRUE per Unicode, FALSE per ANSI.

[in, optional] Credentials

Puntatore a una struttura SEC_WINNT_AUTH_IDENTITY_W o a una struttura SEC_WINNT_AUTH_IDENTITY_A che contiene il nome, il dominio e la password dell'account da usare in un aggiornamento dinamico sicuro. Se CredentialFlags è impostato su TRUE, Credentials punta a una struttura di SEC_WINNT_AUTH_IDENTITY_W; in caso contrario, credenziali punta a una struttura di SEC_WINNT_AUTH_IDENTITY_A. Se non specificato, vengono usate le credenziali del servizio chiamante. Questo parametro è facoltativo.

[out] pContext

Puntatore a un handle che punta alle credenziali restituite.

Valore restituito

Restituisce la conferma dell'esito positivo al completamento. In caso contrario, restituisce il codice di errore specifico del DNS appropriato, come definito in Winerror.h.

Fabbisogno

Vedere anche

DNS_RECORD

DnsQuery

SEC_WINNT_AUTH_IDENTITY