次の方法で共有


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 の既定の資格情報ハンドルが作成されます。 それ以外の場合は、ユーザー が存在する必要があります。 Domain パラメーターは、UPN 形式のユーザーなど、ユーザー 完全修飾されている場合に NULL を できます。たとえば、"" などです。

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

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

手記

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

必要条件

要件 価値
サポートされる最小クライアント Windows Vista
サポートされる最小サーバー Windows Server 2008
ターゲット プラットフォーム の ウィンドウズ
ヘッダー ntdsapi.h
ライブラリ Ntdsapi.lib
DLL Ntdsapi.dll

関連項目

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

DsBindWithCred の

DsFreePasswordCredentials

DsUnbind

RPC_AUTH_IDENTITY_HANDLE