PFN_CRYPT_OBJECT_LOCATOR_PROVIDER_FREE_PASSWORD function pointer
The PFN_CRYPT_OBJECT_LOCATOR_PROVIDER_FREE_PASSWORD callback function releases the password used to encrypt a personal information exchange (PFX) byte array.
Syntax
typedef void ( WINAPI *PFN_CRYPT_OBJECT_LOCATOR_PROVIDER_FREE_PASSWORD)( _In_opt_ LPVOID pPluginContext, _In_ PCWSTR pwszPassword );
Parameters
- pPluginContext [in, optional]
-
Pointer to an optional buffer defined by this provider and returned by the PFN_CRYPT_OBJECT_LOCATOR_PROVIDER_INITIALIZE function. The buffer is not modified by the caller. Your provider can use the data to help it determine what actions to perform or to maintain additional information.
- pwszPassword [in]
-
Null-terminated Unicode string that contains the password.
Return value
Do not return a value from this function.
Remarks
The PFN_CRYPT_OBJECT_LOCATOR_PROVIDER_FREE_PASSWORD function is currently called by only the Secure Channel (Schannel) security package. Schannel calls PFN_CRYPT_OBJECT_LOCATOR_PROVIDER_GET to retrieve a PFX byte array and then calls PFN_CRYPT_OBJECT_LOCATOR_PROVIDER_FREE_PASSWORD after the byte array has been processed but before calling the PFN_CRYPT_OBJECT_LOCATOR_PROVIDER_FREE_IDENTIFIER function.
Requirements
|
Minimum supported client |
Windows 8 [desktop apps only] |
|---|---|
|
Minimum supported server |
Windows Server 2012 [desktop apps only] |
|
Header |
|
See also
- CRYPT_OBJECT_LOCATOR_PROVIDER_TABLE
- PFN_CRYPT_OBJECT_LOCATOR_PROVIDER_GET
- PFN_CRYPT_OBJECT_LOCATOR_PROVIDER_INITIALIZE