Função DnsAcquireContextHandle_A (windns.h)
O tipo de função DnsAcquireContextHandle adquire um identificador de contexto para um conjunto de credenciais. Como muitas funções DNS, o tipo de função DnsAcquireContextHandle é implementado em várias formas para facilitar a codificação de caracteres diferente. Com base na codificação de caracteres envolvida, use uma das seguintes funções:
- DnsAcquireContextHandle_A (_A para codificação ANSI)
- DnsAcquireContextHandle_W (_W para codificação Unicode)
Sintaxe
DNS_STATUS DnsAcquireContextHandle_A(
[in] DWORD CredentialFlags,
[in, optional] PVOID Credentials,
[out] PHANDLE pContext
);
Parâmetros
[in] CredentialFlags
Um sinalizador que indica a codificação de caracteres. Defina como TRUE para Unicode, FALSE para ANSI.
[in, optional] Credentials
Um ponteiro para uma estrutura SEC_WINNT_AUTH_IDENTITY_W ou uma estrutura SEC_WINNT_AUTH_IDENTITY_A que contém o nome, o domínio e a senha da conta a ser usada em uma atualização dinâmica segura. Se CredentialFlags estiver definido como TRUE, Credenciais apontarão para uma estrutura SEC_WINNT_AUTH_IDENTITY_W ; caso contrário, Credenciais apontam para uma estrutura de SEC_WINNT_AUTH_IDENTITY_A . Se não for especificado, as credenciais do serviço de chamada serão usadas. Esse parâmetro é opcional.
[out] pContext
Um ponteiro para um identificador apontando para as credenciais retornadas.
Retornar valor
Retorna a confirmação de êxito após a conclusão bem-sucedida. Caso contrário, retorna o código de erro específico do DNS apropriado, conforme definido em Winerror.h.
Requisitos
| Requisito | Valor |
|---|---|
| Cliente mínimo com suporte | Windows 2000 Professional [somente aplicativos da área de trabalho] |
| Servidor mínimo com suporte | Windows 2000 Server [somente aplicativos da área de trabalho] |
| Plataforma de Destino | Windows |
| Cabeçalho | windns.h |
| Biblioteca | Dnsapi.lib |
| DLL | Dnsapi.dll |