funzione DnsAcquireContextHandle_A (windns.h)

Il tipo di funzione DnsAcquireContextHandle acquisisce un handle di contesto in un set di credenziali. Come molte funzioni DNS, il tipo di funzione DnsAcquireContextHandle viene implementato in più moduli per facilitare la codifica dei caratteri diversa. In base alla codifica dei caratteri coinvolta, 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, le credenziali puntano a una struttura SEC_WINNT_AUTH_IDENTITY_W ; in caso contrario, le credenziali puntano a una struttura SEC_WINNT_AUTH_IDENTITY_A . Se non specificato, vengono usate le credenziali del servizio chiamante. Questo parametro è facoltativo e,

[out] pContext

Puntatore a un handle che punta alle credenziali restituite.

Valore restituito

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

Requisiti

Requisito	Valore
Client minimo supportato	Windows 2000 Professional [solo app desktop]
Server minimo supportato	Windows 2000 Server [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	windns.h
Libreria	Dnsapi.lib
DLL	Dnsapi.dll

Vedi anche

DNS_RECORD

DnsQuery

SEC_WINNT_AUTH_IDENTITY