DsMakePasswordCredentialsA 函式（ntdsapi.h）

發行項
11/20/2024

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、默認認證句柄。否則，使用者 必須存在。當 使用者 完整時，網域參數可能會 NULL，例如 UPN 格式的使用者;例如， “someone@fabrikam.com”

當 pAuthIdentity 傳回的句柄傳遞至 DsBindWithCred時，必須先呼叫 DsUnBind，才能釋放具有 DsFreePasswordCredentials的句柄。一般序列為：

呼叫 DsMakePasswordCredentials 以取得認證句柄。
呼叫 DsBindWithCred，並傳遞認證句柄。
當不再需要系結時，呼叫 DsUnbind。
呼叫 DsFreePasswordCredentials 釋放認證句柄。

注意

ntdsapi.h 標頭會根據 UNICODE 預處理器常數的定義，將 DsMakePasswordCredentials 定義為自動選取此函式的 ANSI 或 Unicode 版本。混合使用編碼中性別名與非編碼中性的程序代碼，可能會導致編譯或運行時間錯誤不符。如需詳細資訊，請參閱函式原型的慣例。

要求

要求	價值
最低支援的用戶端	Windows Vista
支援的最低伺服器	Windows Server 2008
目標平臺	窗戶
標頭	ntdsapi.h
連結庫	Ntdsapi.lib
DLL	Ntdsapi.dll