DnsAcquireContextHandle_W, 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_W(
[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
| 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 |