DsMakePasswordCredentialsA 関数 (ntdsapi.h)

  • [アーティクル]

DsMakePasswordCredentials 関数は、DsBindWithCred 関数で使用するのに適した資格情報ハンドルを構築します。

構文

NTDSAPI DWORD DsMakePasswordCredentialsA(
  [in]  LPCSTR                   User,
  [in]  LPCSTR                   Domain,
  [in]  LPCSTR                   Password,
  [out] RPC_AUTH_IDENTITY_HANDLE *pAuthIdentity
);

パラメーター

[in] User

資格情報に使用するユーザー名を含む null で終わる文字列へのポインター。

[in] Domain

ユーザーがメンバーであるドメインを含む null で終わる文字列へのポインター。

[in] Password

資格情報に使用するパスワードを含む null で終わる文字列へのポインター。

[out] pAuthIdentity

資格情報ハンドルを受け取る RPC_AUTH_IDENTITY_HANDLE 値へのポインター。 このハンドルは、 DsBindWithCred の後続の呼び出しで使用されます。 このハンドルは、不要になったときに DsFreePasswordCredentials 関数を使用して解放する必要があります。

戻り値

次のような Windows エラー コードを返します。

注釈

ユーザー、ドメイン、パスワードがすべて NULL の場合、null の既定の資格情報ハンドルが作成されます。 それ以外の場合は、 ユーザー が存在する必要があります。 User が完全修飾されている場合(UPN 形式のユーザーなど)、Domain パラメーターは NULL になる場合があります。たとえば、"someone@fabrikam.com" です。

pAuthIdentity で返されたハンドルが DsBindWithCred に渡される場合は、DsFreePasswordCredentials を使用してハンドルを解放する前に DsUnBind を呼び出す必要があります。 通常のシーケンスは次のとおりです。

  1. DsMakePasswordCredentials を呼び出して、資格情報ハンドルを取得します。
  2. DsBindWithCred を呼び出し、資格情報ハンドルを渡します。
  3. バインドが不要になったときに DsUnbind を呼び出します。
  4. DsFreePasswordCredentials を呼び出して、資格情報ハンドルを解放します。

注意

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

要件

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

こちらもご覧ください

ドメイン コントローラーとレプリケーション管理機能

DsBindWithCred

DsFreePasswordCredentials

DsUnbind

RPC_AUTH_IDENTITY_HANDLE