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

Consulte también

DNS_RECORD

DnsQuery

SEC_WINNT_AUTH_IDENTITY