DnsAcquireContextHandle_A-Funktion (windns.h)
Der Funktionstyp DnsAcquireContextHandle ruft ein Kontexthandle für eine Gruppe von Anmeldeinformationen ab. Wie viele DNS-Funktionen wird auch der DnsAcquireContextHandle-Funktionstyp in mehreren Formen implementiert, um eine unterschiedliche Zeichencodierung zu ermöglichen. Verwenden Sie basierend auf der betreffenden Zeichencodierung eine der folgenden Funktionen:
- DnsAcquireContextHandle_A (_A für DIE ANSI-Codierung)
- DnsAcquireContextHandle_W (_W für unicode-Codierung)
Syntax
DNS_STATUS DnsAcquireContextHandle_A(
[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, weisen Anmeldeinformationen auf eine SEC_WINNT_AUTH_IDENTITY_W-Struktur hin. Andernfalls verweist Anmeldeinformationen auf eine SEC_WINNT_AUTH_IDENTITY_A-Struktur . Falls 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 nach erfolgreichem Abschluss eine Erfolgsbestätigung zurück. Andernfalls wird der entsprechende DNS-spezifische Fehlercode zurückgegeben, der in Winerror.h definiert ist.
Anforderungen
| Anforderung | Wert |
|---|---|
| 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 |