dsFreePasswordCredentials 函式 (ntdsapi.h)

DsFreePasswordCredentials 函式會釋放 DsMakePasswordCredentials 函式為認證結構配置的記憶體。

語法

NTDSAPI VOID DsFreePasswordCredentials(
  [in] RPC_AUTH_IDENTITY_HANDLE AuthIdentity
);

參數

[in] AuthIdentity

要釋放之認證結構的句柄。

傳回值

此函式不會傳回值。

備註

當 AuthIdentity 中的句柄傳遞至 DsBindWithCred 時,必須先呼叫 DsUnbind ,才能釋放此句柄。 一般事件順序為:

  1. 呼叫 DsMakePasswordCredentials 以取得認證句柄。
  2. 呼叫 DsBindWithCred,傳遞認證句柄。
  3. 不再需要 RPC 連線時,請呼叫 DsUnbind 。
  4. 呼叫 DsFreePasswordCredentials 以釋放認證句柄。

規格需求

需求 值
最低支援的用戶端 Windows Vista
最低支援的伺服器 Windows Server 2008
目標平台 Windows
標頭 ntdsapi.h
程式庫 Ntdsapi.lib
Dll Ntdsapi.dll

另請參閱

域控制器和復寫管理功能

DsBindWithCred

DsMakePasswordCredentials

DsUnbind