PFE_EXPORT_FUNC funzione di callback (winbase.h)

Articolo
03/08/2023

Funzione di callback definita dall'applicazione usata con ReadEncryptedFileRaw. Il sistema chiama ExportCallback una o più volte, ogni volta con un blocco dei dati del file crittografato, fino a quando non ha ricevuto tutti i dati del file. ExportCallback scrive i dati del file crittografato in un altro supporto di archiviazione, in genere ai fini del backup del file.

Il tipo PFE_EXPORT_FUNC definisce un puntatore alla funzione di callback. ExportCallback è un segnaposto per il nome della funzione definita dall'applicazione.

Sintassi

PFE_EXPORT_FUNC PfeExportFunc;

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

Parametri

[in] pbData

Puntatore a un blocco dei dati del file crittografato di cui eseguire il backup. Questo blocco di dati viene allocato dal sistema.

[in, optional] pvCallbackContext

Puntatore a un blocco di contesto definito dall'applicazione e allocato. L'applicazione passa questo puntatore a ReadEncryptedFileRaw e ReadEncryptedFileRaw passa questo puntatore alla funzione di callback in modo che possa accedere ai dati specifici dell'applicazione. Questi dati possono essere una struttura e possono contenere tutti i dati necessari all'applicazione, ad esempio l'handle nel file che contiene la copia di backup del file crittografato.

[in] ulLength

Dimensioni dei dati a cui punta il parametro pbData , in byte.

Valore restituito

Se la funzione ha esito positivo, deve impostare il valore restituito su ERROR_SUCCESS.

Se la funzione ha esito negativo, impostare il valore restituito su un codice di errore diverso da zero definito in WinError.h. Ad esempio, se questa funzione ha esito negativo perché un'API che chiama ha esito negativo, è possibile impostare il valore restituito sul valore restituito da GetLastError per l'API non riuscita.

Commenti

È possibile usare il blocco di contesto definito dall'applicazione per il rilevamento interno delle informazioni, ad esempio l'handle di file e l'offset corrente nel file.

Requisiti

Requisito	Valore
Client minimo supportato	Windows XP [solo app desktop]
Server minimo supportato	Windows Server 2003 [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	winbase.h (include Windows.h)