DsBindWithCredA 関数 (ntdsapi.h)

[アーティクル]
02/29/2024

DsBindWithCred 関数は、指定した資格情報を使用してドメインコントローラーにバインドします。

構文

NTDSAPI DWORD DsBindWithCredA(
  [in, optional] LPCSTR                   DomainControllerName,
  [in, optional] LPCSTR                   DnsDomainName,
  [in, optional] RPC_AUTH_IDENTITY_HANDLE AuthIdentity,
  [out]          HANDLE                   *phDS
);

パラメーター

[in, optional] DomainControllerName

バインドするドメインの完全修飾 DNS 名を含む null で終わる文字列へのポインター。このパラメーターの詳細については、DsBind トピックの DomainControllerName の説明を参照してください。

[in, optional] DnsDomainName

バインドするドメインの完全修飾 DNS 名を含む null で終わる文字列へのポインター。このパラメーターの詳細については、DsBind トピックの DnsDomainName の説明を参照してください。

Kerberos 認証をセキュリティで保護するには、このパラメーターが必要です。

[in, optional] AuthIdentity

バインドに使用する資格情報を表す RPC_AUTH_IDENTITY_HANDLE 値を格納します。次に、

DsMakePasswordCredentials 関数を使用して、この値を取得します。このパラメーターが NULL の場合は、呼び出し元スレッドの資格情報が使用されます。

DsFreePasswordCredentials 関数を使用してこのハンドルを解放する前に、DsUnBind を呼び出す必要があります。

[out] phDS

バインドハンドルを受け取る HANDLE 値のアドレス。このハンドルを閉じるには、 DsUnBind 関数に渡します。

戻り値

成功した場合 はERROR_SUCCESS 、それ以外の場合は Windows または RPC エラーコードを返します。最も一般的なエラーコードを次に示します。

注釈

注意

ntdsapi.h ヘッダーは、DsBindWithCred をエイリアスとして定義します。このエイリアスは、UNICODE プリプロセッサ定数の定義に基づいて、この関数の ANSI または Unicode バージョンを自動的に選択します。 encoding-neutral エイリアスの使用を encoding-neutral ではないコードと混在すると、コンパイルエラーまたはランタイムエラーが発生する不一致が発生する可能性があります。詳細については、「関数プロトタイプの規則」を参照してください。

要件

要件	値
サポートされている最小のクライアント	Windows Vista
サポートされている最小のサーバー	Windows Server 2008
対象プラットフォーム	Windows
ヘッダー	ntdsapi.h
Library	Ntdsapi.lib
[DLL]	Ntdsapi.dll