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 |