次の方法で共有


DnsAcquireContextHandle_W関数 (windns.h)

DnsAcquireContextHandle 関数型は、資格情報のセットへのコンテキスト ハンドルを取得します。 多くの DNS 関数と同様に、DnsAcquireContextHandle 関数型は、異なる文字エンコードを容易にするために複数の形式で実装されています。 関連する文字エンコードに基づいて、次のいずれかの関数を使用します。

  • DnsAcquireContextHandle_A (ANSI エンコードの_A)
  • DnsAcquireContextHandle_W (Unicode エンコードの_W)

構文

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 固有のエラー コードを返します。

必要条件

要件 価値
サポートされる最小クライアント Windows 2000 Professional [デスクトップ アプリのみ]
サポートされる最小サーバー Windows 2000 Server [デスクトップ アプリのみ]
ターゲット プラットフォーム の ウィンドウズ
ヘッダー windns.h
ライブラリ Dnsapi.lib
DLL Dnsapi.dll

関連項目

DNS_RECORD

DnsQuery

SEC_WINNT_AUTH_IDENTITY