fonction DnsAcquireContextHandle_W (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 formulaires pour faciliter l’encodage de caractères différent. 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_W(
[in] DWORD CredentialFlags,
[in, optional] PVOID Credentials,
[out] PHANDLE pContext
);
Paramètres
[in] CredentialFlags
Indicateur qui indique l’encodage de caractères. Défini sur TRUE pour Unicode, FALSE pour ANSI.
[in, optional] Credentials
Pointeur vers une structure SEC_WINNT_AUTH_IDENTITY_W ou une structure 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 de SEC_WINNT_AUTH_IDENTITY_W ; sinon, Informations d’identification pointe vers une structure de SEC_WINNT_AUTH_IDENTITY_A. S’il n’est pas spécifié, 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 de retour
Retourne la confirmation de réussite lors de la réussite. Sinon, retourne le code d’erreur propre au DNS approprié tel que défini dans Winerror.h.
Exigences
| Exigence | Valeur |
|---|---|
| client minimum pris en charge | Windows 2000 Professionnel [applications de bureau uniquement] |
| serveur minimum pris en charge | Windows 2000 Server [applications de bureau uniquement] |
| plateforme cible | Windows |
| d’en-tête | windns.h |
| bibliothèque | Dnsapi.lib |
| DLL | Dnsapi.dll |