EN
Ce contenu n’est pas disponible dans votre langue. Voici la version anglaise.

PFN_CRYPT_OBJECT_LOCATOR_PROVIDER_RELEASE function pointer

The PFN_CRYPT_OBJECT_LOCATOR_PROVIDER_RELEASE callback function releases the provider.

Syntax


typedef void ( WINAPI *PFN_CRYPT_OBJECT_LOCATOR_PROVIDER_RELEASE)(
  _In_      DWORD dwReason,
  _In_opt_  LPVOID pPluginContext
);

Parameters

dwReason [in]

Specifies the reason the provider is being released. This can be one of the following values:

ValueMeaning
CRYPT_OBJECT_LOCATOR_RELEASE_SYSTEM_SHUTDOWN
1

The computer is shutting down.

CRYPT_OBJECT_LOCATOR_RELEASE_SERVICE_STOP
2

The service is stopping.

CRYPT_OBJECT_LOCATOR_RELEASE_PROCESS_EXIT
3

The calling process is ending.

CRYPT_OBJECT_LOCATOR_RELEASE_DLL_UNLOAD
4

The provider DLL is unloading.

 

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.

Return value

Do not return a value from this function.

Remarks

The PFN_CRYPT_OBJECT_LOCATOR_PROVIDER_RELEASE callback function is currently called by only the Secure Channel (Schannel) security package. This function is called once for every call made to PFN_CRYPT_OBJECT_LOCATOR_PROVIDER_INITIALIZE.

The provider is not expected to release all memory for all objects but should clean itself if the dwReason parameter is set to CRYPT_OBJECT_LOCATOR_RELEASE_SERVICE_STOP or CRYPT_OBJECT_LOCATOR_RELEASE_DLL_UNLOAD.

This function must block so that calls to PFN_CRYPT_OBJECT_LOCATOR_PROVIDER_FLUSH can complete.

Requirements

Minimum supported client

Windows 8 [desktop apps only]

Minimum supported server

Windows Server 2012 [desktop apps only]

Header

Wincrypt.h

See also

CRYPT_OBJECT_LOCATOR_PROVIDER_TABLE
PFN_CRYPT_OBJECT_LOCATOR_PROVIDER_INITIALIZE

 

 

Ajouts de la communauté

AJOUTER
Afficher:
© 2014 Microsoft