DnsAcquireContextHandle_A, fonction (windns.h)

Le type de fonction DnsAcquireContextHandle acquiert un handle de contexte pour un ensemble d’informations d’identification. Comme de nombreuses fonctions DNS, le type de fonction DnsAcquireContextHandle est implémenté dans plusieurs formes pour faciliter l’encodage de caractères différents. En fonction de l’encodage de caractères impliqué, utilisez l’une des fonctions suivantes :

  • DnsAcquireContextHandle_A (_A pour l’encodage ANSI)
  • DnsAcquireContextHandle_W (_W pour l’encodage Unicode)

Syntaxe

DNS_STATUS DnsAcquireContextHandle_A(
  [in]           DWORD   CredentialFlags,
  [in, optional] PVOID   Credentials,
  [out]          PHANDLE pContext
);

Paramètres

[in] CredentialFlags

Indicateur qui indique l’encodage des caractères. Définissez sur TRUE pour Unicode, FALSE pour ANSI.

[in, optional] Credentials

Pointeur vers une structure SEC_WINNT_AUTH_IDENTITY_W ou une structure de SEC_WINNT_AUTH_IDENTITY_A qui contient le nom, le domaine et le mot de passe du compte à utiliser dans une mise à jour dynamique sécurisée. Si CredentialFlags a la valeur TRUE, Credentials pointe vers une structure SEC_WINNT_AUTH_IDENTITY_W ; sinon, Credentials pointe vers une structure SEC_WINNT_AUTH_IDENTITY_A . Si elles ne sont pas spécifiées, les informations d’identification du service appelant sont utilisées. Ce paramètre est facultatif.

[out] pContext

Pointeur vers un handle pointant vers les informations d’identification retournées.

Valeur retournée

Retourne la confirmation de réussite en cas de réussite. Sinon, retourne le code d’erreur dns approprié tel que défini dans Winerror.h.

Configuration requise

Condition requise Valeur
Client minimal pris en charge Windows 2000 Professionnel [applications de bureau uniquement]
Serveur minimal pris en charge Windows 2000 Server [applications de bureau uniquement]
Plateforme cible Windows
En-tête windns.h
Bibliothèque Dnsapi.lib
DLL Dnsapi.dll

Voir aussi

DNS_RECORD

DnsQuery

SEC_WINNT_AUTH_IDENTITY