função DnsAcquireContextHandle_W (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_W(
[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, de Credenciais aponta para uma estrutura de SEC_WINNT_AUTH_IDENTITY_W; caso contrário, de Credenciais aponta 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.
Valor de retorno
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 |
|---|---|
| de cliente com suporte mínimo | Windows 2000 Professional [somente aplicativos da área de trabalho] |
| servidor com suporte mínimo | Windows 2000 Server [somente aplicativos da área de trabalho] |
| da Plataforma de Destino |
Windows |
| cabeçalho | windns.h |
| biblioteca | Dnsapi.lib |
| de DLL |
Dnsapi.dll |