PFE_IMPORT_FUNC funzione di callback (winbase.h)

Articolo
08/27/2023

Funzione di callback definita dall'applicazione usata con WriteEncryptedFileRaw. Il sistema chiama ImportCallback una o più volte, ogni volta per recuperare una parte dei dati di un file di backup. ImportCallback legge i dati da un file di backup in sequenza e ripristina i dati e il sistema continua a chiamarlo finché non ha letto tutti i dati del file di backup.

Il tipo PFE_IMPORT_FUNC definisce un puntatore a questa funzione di callback. ImportCallback è un segnaposto per il nome della funzione definita dall'applicazione.

Sintassi

PFE_IMPORT_FUNC PfeImportFunc;

DWORD PfeImportFunc(
  [in]           PBYTE pbData,
  [in, optional] PVOID pvCallbackContext,
  [in, out]      PULONG ulLength
)
{...}

Parametri

[in] pbData

Puntatore a un buffer fornito dal sistema che riceverà un blocco di dati da ripristinare.

[in, optional] pvCallbackContext

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

[in, out] ulLength

Nella voce della funzione questo parametro specifica la lunghezza del buffer fornito dal sistema. La funzione di callback deve scrivere non più di questo numero di byte nel buffer a cui punta il parametro pbData .

In uscita, la funzione deve impostare questo valore sul numero di byte di dati scritti nel pbData.

Valore restituito

Se la funzione ha esito positivo, deve impostare il valore restituito su ERROR_SUCCESS e impostare il valore a cui punta il parametro ulLength sul numero di byte copiati in pbData.

Al termine del file di backup, impostare ulLength su zero per indicare al sistema che l'intero file è stato elaborato.

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

Il sistema chiama la funzione ImportCallback fino a quando la funzione di callback indica che non sono presenti più dati da ripristinare. Per indicare che non sono presenti più dati da ripristinare, impostare *ulLength su 0 e usare un codice restituito di ERROR_SUCCESS. È 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


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)