DnsAcquireCoNtextHandle_W函式 (windns.h)

DnsAcquireCoNtextHandle函式類型會取得一組認證的內容控制碼。 如同許多 DNS 函式， DnsAcquireCoNtextHandle 函式類型會以多個形式實作，以利不同的字元編碼。 根據涉及的字元編碼方式，使用下列其中一個函式：

• ANSI 編碼) 的DnsAcquireCoNtextHandle_A (_A
• DnsAcquireCoNtextHandle_W (_W Unicode 編碼)

語法

DNS_STATUS DnsAcquireContextHandle_W(
  [in]           DWORD   CredentialFlags,
  [in, optional] PVOID   Credentials,
  [out]          PHANDLE pContext
);

參數

[in] CredentialFlags

表示字元編碼的旗標。 針對 Unicode 設定為 TRUE ，ANSI 則為 FALSE 。

[in, optional] Credentials

SEC_WINNT_AUTH_IDENTITY_W結構的指標或包含安全動態更新中所用帳戶名稱、網域和密碼的SEC_WINNT_AUTH_IDENTITY_A結構。 如果 CredentialFlags 設定為 TRUE， 則認證 會指向 SEC_WINNT_AUTH_IDENTITY_W 結構;否則， 認證 會指向 SEC_WINNT_AUTH_IDENTITY_A 結構。 如果未指定，則會使用呼叫服務的認證。 這是選擇性參數。

[out] pContext

指向傳回之認證的控制碼指標。

傳回值

在成功完成時傳回成功確認。 否則，傳回如 Winerror.h 中所定義的適當 DNS 特定錯誤碼。

規格需求

另請參閱

DNS_RECORD

DnsQuery

SEC_WINNT_AUTH_IDENTITY