PFNCryptStreamOutputCallback-Rückruffunktion (ncryptprotect.h)
Die PFNCryptStreamOutputCallback-Funktion empfängt verschlüsselte oder entschlüsselte Daten von Aufgaben, die mithilfe der Funktionen NCryptStreamOpenToProtect oder NCryptStreamOpenToUnprotect gestartet werden. Dieser Rückruf muss von Ihrer Anwendung mit der folgenden Syntax definiert werden.
Syntax
PFNCryptStreamOutputCallback Pfncryptstreamoutputcallback;
SECURITY_STATUS Pfncryptstreamoutputcallback(
[in] void *pvCallbackCtxt,
[in] const BYTE *pbData,
SIZE_T cbData,
BOOL fFinal
)
{...}
Parameter
[in] pvCallbackCtxt
Zeiger auf Daten, die Sie verwenden können, um Ihre Anwendung nachzuverfolgen. Die Daten werden von der Datenschutz-API nicht geändert.
[in] pbData
Zeiger auf einen Block verarbeiteter Daten, der von der Anwendung verwendet werden kann.
cbData
Die Größe der verarbeiteten Daten in Bytes, auf die der pbData-Parameter verweist.
fFinal
Wenn dieser Wert TRUE ist, ist der aktuelle Datenblock der letzte, der verarbeitet wird, und dies ist das letzte Mal, dass der Rückruf aufgerufen wird.
Rückgabewert
Wenn Sie einen anderen status Code als ERROR_SUCCESS aus Ihrer Implementierung dieser Rückruffunktion zurückgeben, schlägt die Datenstromverschlüsselung oder -entschlüsselung fehl.
| Rückgabecode | Beschreibung |
|---|---|
|
Die Funktion war erfolgreich. |
Hinweise
Legen Sie einen Zeiger auf diese Rückruffunktion im pfnStreamOutput-Element der NCRYPT_PROTECT_STREAM_INFO-Struktur fest. Legen Sie einen Zeiger auf die Struktur im pStreamInfo-Parameter der Funktionen NCryptStreamOpenToProtect oder NCryptStreamOpenToUnprotect fest.
Sie können diesen Rückruf verwenden, um die verschlüsselten oder entschlüsselten Daten weiterzuverarbeiten. Eine häufige Verwendung der Funktion besteht darin, die Daten auf den Datenträger zu schreiben, wenn sie von der Datenschutz-API empfangen werden. Die Blöcke verschlüsselter oder unverschlüsselter Daten werden von der NCryptStreamUpdate-Funktion erstellt.
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) | Windows 8 [nur Desktop-Apps] |
| Unterstützte Mindestversion (Server) | Windows Server 2012 [nur Desktop-Apps] |
| Zielplattform | Windows |
| Kopfzeile | ncryptprotect.h |