PFE_EXPORT_FUNC Rückruffunktion (winbase.h)
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) |