DnsAcquireContextHandle_W-Funktion (windns.h)
Der Funktionstyp DnsAcquireContextHandle ruft ein Kontexthandle für einen Satz von Anmeldeinformationen ab. Wie viele dns-Funktionen wird auch der Funktionstyp DnsAcquireContextHandle in mehreren Formen implementiert, um unterschiedliche Zeichencodierungen zu ermöglichen. Verwenden Sie basierend auf der beteiligten Zeichencodierung eine der folgenden Funktionen:
- DnsAcquireContextHandle_A (_A für DIE ANSI-Codierung)
- DnsAcquireContextHandle_W (_W für Unicode-Codierung)
Syntax
DNS_STATUS DnsAcquireContextHandle_W(
[in] DWORD CredentialFlags,
[in, optional] PVOID Credentials,
[out] PHANDLE pContext
);
Parameter
[in] CredentialFlags
Ein Flag, das die Zeichencodierung angibt. Legen Sie für Unicode auf TRUE und für ANSI auf FALSE fest.
[in, optional] Credentials
Ein Zeiger auf eine SEC_WINNT_AUTH_IDENTITY_W-Struktur oder eine SEC_WINNT_AUTH_IDENTITY_A-Struktur , die den Namen, die Domäne und das Kennwort des Kontos enthält, das in einem sicheren dynamischen Update verwendet werden soll. Wenn CredentialFlags auf TRUE festgelegt ist, verweist Credentials auf eine SEC_WINNT_AUTH_IDENTITY_W-Struktur . Andernfalls verweist Anmeldeinformationen auf eine SEC_WINNT_AUTH_IDENTITY_A-Struktur . Wenn nicht angegeben, werden die Anmeldeinformationen des aufrufenden Diensts verwendet. Dieser Parameter ist optional.
[out] pContext
Ein Zeiger auf ein Handle, das auf die zurückgegebenen Anmeldeinformationen verweist.
Rückgabewert
Gibt die Erfolgsbestätigung nach erfolgreichem Abschluss zurück. Gibt andernfalls den entsprechenden DNS-spezifischen Fehlercode zurück, wie in Winerror.h definiert.
Anforderungen
| Unterstützte Mindestversion (Client) | Windows 2000 Professional [nur Desktop-Apps] |
| Unterstützte Mindestversion (Server) | Windows 2000 Server [nur Desktop-Apps] |
| Zielplattform | Windows |
| Kopfzeile | windns.h |
| Bibliothek | Dnsapi.lib |
| DLL | Dnsapi.dll |