PFE_EXPORT_FUNC função de retorno de chamada (winbase.h)

Artigo
03/13/2024

Uma função de retorno de chamada definida pelo aplicativo usada com ReadEncryptedFileRaw. O sistema chama ExportCallback uma ou mais vezes, cada vez com um bloco de dados do arquivo criptografado, até que ele tenha recebido todos os dados do arquivo. ExportCallback grava os dados do arquivo criptografado em outra mídia de armazenamento, geralmente para fins de backup do arquivo.

O tipo PFE_EXPORT_FUNC define um ponteiro para a função de retorno de chamada. ExportCallback é um espaço reservado para o nome da função definida pelo aplicativo.

Sintaxe

PFE_EXPORT_FUNC PfeExportFunc;

DWORD PfeExportFunc(
  [in]           PBYTE pbData,
  [in, optional] PVOID pvCallbackContext,
  [in]           ULONG ulLength
)
{...}

Parâmetros

[in] pbData

Um ponteiro para um bloco dos dados do arquivo criptografado a ser copiado em backup. Esse bloco de dados é alocado pelo sistema.

[in, optional] pvCallbackContext

Um ponteiro para um bloco de contexto definido pelo aplicativo e alocado. O aplicativo passa esse ponteiro para ReadEncryptedFileRaw e ReadEncryptedFileRaw passa esse ponteiro para a função de retorno de chamada para que ele possa ter acesso a dados específicos do aplicativo. Esses dados podem ser uma estrutura e podem conter quaisquer dados de que o aplicativo precise, como o identificador para o arquivo que contém a cópia de backup do arquivo criptografado.

[in] ulLength

O tamanho dos dados apontados pelo parâmetro pbData , em bytes.

Retornar valor

Se a função for bem-sucedida, ela deverá definir o valor retornado como ERROR_SUCCESS.

Se a função falhar, defina o valor retornado como um código de erro diferente de zero definido em WinError.h. Por exemplo, se essa função falhar porque uma API que ela chama falhar, você poderá definir o valor retornado para o valor retornado por GetLastError para a API com falha.

Comentários

Você pode usar o bloco de contexto definido pelo aplicativo para acompanhamento interno de informações, como o identificador de arquivo e o deslocamento atual no arquivo.

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Windows XP [somente aplicativos da área de trabalho]
Servidor mínimo com suporte	Windows Server 2003 [somente aplicativos da área de trabalho]
Plataforma de Destino	Windows
Cabeçalho	winbase.h (incluir Windows.h)