PFN_CRYPT_OBJECT_LOCATOR_PROVIDER_RELEASE função de retorno de chamada (wincrypt.h)

  • Artigo

A função de retorno de chamada PFN_CRYPT_OBJECT_LOCATOR_PROVIDER_RELEASE libera o provedor.

Sintaxe

PFN_CRYPT_OBJECT_LOCATOR_PROVIDER_RELEASE PfnCryptObjectLocatorProviderRelease;

void PfnCryptObjectLocatorProviderRelease(
  [in]           DWORD dwReason,
  [in, optional] LPVOID pPluginContext
)
{...}

Parâmetros

[in] dwReason

Especifica o motivo pelo qual o provedor está sendo liberado. Esse valor pode ser um dos seguintes:

Valor Significado
CRYPT_OBJECT_LOCATOR_RELEASE_SYSTEM_SHUTDOWN
1
 O computador está desligando.
CRYPT_OBJECT_LOCATOR_RELEASE_SERVICE_STOP
2
 Serviço está parando.
CRYPT_OBJECT_LOCATOR_RELEASE_PROCESS_EXIT
3
 O processo de chamada está terminando.
CRYPT_OBJECT_LOCATOR_RELEASE_DLL_UNLOAD
4
 A DLL do provedor está sendo descarregada.

[in, optional] pPluginContext

Ponteiro para um buffer opcional definido por esse provedor e retornado pela função PFN_CRYPT_OBJECT_LOCATOR_PROVIDER_INITIALIZE . O buffer não é modificado pelo chamador. Seu provedor pode usar os dados para ajudá-lo a determinar quais ações executar ou manter informações adicionais.

Retornar valor

Nenhum

Comentários

A função de retorno de chamada PFN_CRYPT_OBJECT_LOCATOR_PROVIDER_RELEASE atualmente é chamada apenas pelo pacote de segurança Schannel (Canal Seguro). Essa função é chamada uma vez para cada chamada feita para PFN_CRYPT_OBJECT_LOCATOR_PROVIDER_INITIALIZE.

Não se espera que o provedor libere toda a memória de todos os objetos, mas deverá limpo se o parâmetro dwReason estiver definido como CRYPT_OBJECT_LOCATOR_RELEASE_SERVICE_STOP ou CRYPT_OBJECT_LOCATOR_RELEASE_DLL_UNLOAD.

Essa função deve bloquear para que as chamadas para PFN_CRYPT_OBJECT_LOCATOR_PROVIDER_FLUSH possam ser concluídas.

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows 8 [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Windows Server 2012 [somente aplicativos da área de trabalho]
Plataforma de Destino Windows
Cabeçalho wincrypt.h

Confira também

CRYPT_OBJECT_LOCATOR_PROVIDER_TABLE

PFN_CRYPT_OBJECT_LOCATOR_PROVIDER_INITIALIZE