DnsAcquireContextHandle_A función (windns.h)
El tipo de función DnsAcquireContextHandle adquiere un identificador de contexto para un conjunto de credenciales. Al igual que muchas funciones DNS, el tipo de función DnsAcquireContextHandle se implementa en varios formularios para facilitar la codificación de caracteres diferente. En función de la codificación de caracteres implicada, use una de las siguientes funciones:
- DnsAcquireContextHandle_A (_A para la codificación ANSI)
- DnsAcquireContextHandle_W (_W para la codificación Unicode)
Sintaxis
DNS_STATUS DnsAcquireContextHandle_A(
[in] DWORD CredentialFlags,
[in, optional] PVOID Credentials,
[out] PHANDLE pContext
);
Parámetros
[in] CredentialFlags
Marca que indica la codificación de caracteres. Se establece en TRUE para Unicode, FALSE para ANSI.
[in, optional] Credentials
Puntero a una estructura de SEC_WINNT_AUTH_IDENTITY_W o a una estructura de SEC_WINNT_AUTH_IDENTITY_A que contiene el nombre, el dominio y la contraseña de la cuenta que se va a usar en una actualización dinámica segura. Si CredentialFlags se establece en TRUE, Credentials apunta a una estructura de SEC_WINNT_AUTH_IDENTITY_W ; De lo contrario, Credentials apunta a una estructura de SEC_WINNT_AUTH_IDENTITY_A . Si no se especifica, se usan las credenciales del servicio de llamada. Este parámetro es opcional.
[out] pContext
Puntero a un identificador que apunta a las credenciales devueltas.
Valor devuelto
Devuelve la confirmación correcta tras la finalización correcta. De lo contrario, devuelve el código de error específico de DNS adecuado, tal como se define en Winerror.h.
Requisitos
| Requisito | Value |
|---|---|
| Cliente mínimo compatible | Windows 2000 Professional [solo aplicaciones de escritorio] |
| Servidor mínimo compatible | Windows 2000 Server [solo aplicaciones de escritorio] |
| Plataforma de destino | Windows |
| Encabezado | windns.h |
| Library | Dnsapi.lib |
| Archivo DLL | Dnsapi.dll |