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

Weitere Informationen

DNS_RECORD

DnsQuery

SEC_WINNT_AUTH_IDENTITY