DsFreePasswordCredentials function (ntdsapi.h)
The DsFreePasswordCredentials function frees memory allocated for a credentials structure by the DsMakePasswordCredentials function.
Syntax
NTDSAPI VOID DsFreePasswordCredentials(
[in] RPC_AUTH_IDENTITY_HANDLE AuthIdentity
);
Parameters
[in] AuthIdentity
Handle of the credential structure to be freed.
Return value
This function does not return a value.
Remarks
When the handle in AuthIdentity is passed to DsBindWithCred, DsUnbind must be called before freeing this handle. The normal sequence of events is:
- Call DsMakePasswordCredentials to obtain the credential handle.
- Call DsBindWithCred, passing the credential handle.
- Call DsUnbind when the RPC connection is no longer required.
- Call DsFreePasswordCredentials to free the credential handle.
Requirements
| Requirement | Value |
|---|---|
| Minimum supported client | Windows Vista |
| Minimum supported server | Windows Server 2008 |
| Target Platform | Windows |
| Header | ntdsapi.h |
| Library | Ntdsapi.lib |
| DLL | Ntdsapi.dll |