PFE_EXPORT_FUNC Rückruffunktion (winbase.h)

Artikel
03/03/2024

Eine anwendungsdefinierte Rückruffunktion, die mit ReadEncryptedFileRaw verwendet wird. Das System ruft ExportCallback mehrmals auf, jedes Mal mit einem Block der Daten der verschlüsselten Datei, bis es alle Dateidaten empfangen hat. ExportCallback schreibt die Daten der verschlüsselten Datei auf ein anderes Speichermedium, in der Regel zum Sichern der Datei.

Der PFE_EXPORT_FUNC-Typs definiert einen Zeiger auf die Rückruffunktion. ExportCallback ist ein Platzhalter für den anwendungsdefinierte Funktionsnamen.

Syntax

PFE_EXPORT_FUNC PfeExportFunc;

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

Parameter

[in] pbData

Ein Zeiger auf einen Block der zu sichernden Daten der verschlüsselten Datei. Dieser Datenblock wird vom System zugeordnet.

[in, optional] pvCallbackContext

Ein Zeiger auf einen anwendungsdefinierten und zugeordneten Kontextblock. Die Anwendung übergibt diesen Zeiger an ReadEncryptedFileRaw, und ReadEncryptedFileRaw übergibt diesen Zeiger an die Rückruffunktion, sodass sie Zugriff auf anwendungsspezifische Daten haben kann. Diese Daten können eine Struktur sein und alle von der Anwendung benötigten Daten enthalten, z. B. das Handle für die Datei, die die Sicherungskopie der verschlüsselten Datei enthält.

[in] ulLength

Die Größe der Daten, auf die der pbData-Parameter in Bytes verweist.

Rückgabewert

Wenn die Funktion erfolgreich ist, muss sie den Rückgabewert auf ERROR_SUCCESS festlegen.

Wenn die Funktion fehlschlägt, legen Sie den Rückgabewert auf einen in WinError.h definierten Nonzero-Fehlercode fest. Wenn diese Funktion beispielsweise fehlschlägt, weil eine API, die sie aufruft, fehlschlägt, können Sie den Rückgabewert auf den Wert festlegen, der von GetLastError für die fehlerhafte API zurückgegeben wird.

Hinweise

Sie können den anwendungsdefinierte Kontextblock für die interne Nachverfolgung von Informationen wie dem Dateihandle und dem aktuellen Offset in der Datei verwenden.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows XP [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2003 [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	winbase.h (einschließlich Windows.h)