DnsAcquireContextHandle_W Funktion (windns.h)

Der DnsAcquireContextHandle Funktionstyp erhält ein Kontexthandle für eine Reihe von Anmeldeinformationen. Wie viele DNS-Funktionen wird der DnsAcquireContextHandle Funktionstyp in mehreren Formen implementiert, um die unterschiedliche Zeichencodierung zu vereinfachen. Verwenden Sie basierend auf der verwendeten 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 Kennzeichen, das die Zeichencodierung angibt. Wird für Unicode auf TRUE festgelegt, FALSE- für ANSI.

[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 TRUEfestgelegt ist, verweist Anmeldeinformationen 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 zeigt.

Rückgabewert

Gibt eine Erfolgsbestätigung nach erfolgreichem Abschluss zurück. Andernfalls wird der entsprechende DNS-spezifische Fehlercode wie in Winerror.h definiert zurückgegeben.

Anforderungen

Siehe auch

DNS_RECORD

DnsQuery-

SEC_WINNT_AUTH_IDENTITY