PFNCryptStreamOutputCallback-Rückruffunktion (ncryptprotect.h)

Artikel
03/04/2024

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.

Hinweis Sie können einen Zeiger auf Ihre Kontextdaten im pvCallbackCtxt-Member der NCRYPT_PROTECT_STREAM_INFO-Struktur festlegen, bevor Sie einen Zeiger auf diese Struktur im pStreamInfo-Parameter der Funktionen NCryptStreamOpenToProtect oder NCryptStreamOpenToUnprotect übergeben.

[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
ERROR_SUCCESS	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