Funzione di callback PFNCryptStreamOutputCallback (ncryptprotect.h)

  • Articolo

La funzione PFNCryptStreamOutputCallback riceve dati crittografati o decrittografati dalle attività avviate usando le funzioni NCryptStreamOpenToProtect o NCryptStreamOpenToUnprotect . Questo callback deve essere definito dall'applicazione usando la sintassi seguente.

Sintassi

PFNCryptStreamOutputCallback Pfncryptstreamoutputcallback;

SECURITY_STATUS Pfncryptstreamoutputcallback(
  [in] void *pvCallbackCtxt,
  [in] const BYTE *pbData,
       SIZE_T cbData,
       BOOL fFinal
)
{...}

Parametri

[in] pvCallbackCtxt

Puntatore ai dati che è possibile usare per tenere traccia dell'applicazione. I dati non sono modificati dall'API di protezione dei dati.

Nota È possibile impostare un puntatore ai dati di contesto nel membro pvCallbackCtxt della struttura NCRYPT_PROTECT_STREAM_INFO prima di passare un puntatore a tale struttura nel parametro pStreamInfo delle funzioni NCryptStreamOpenToProtect o NCryptStreamOpenToUnprotect .
 

[in] pbData

Puntatore a un blocco di dati elaborati che possono essere usati dall'applicazione.

cbData

Dimensione, in byte, dei dati elaborati a cui punta il parametro pbData .

fFinal

Se questo valore è TRUE, il blocco di dati corrente è l'ultimo da elaborare e questa è l'ultima volta che verrà chiamato il callback.

Valore restituito

Se si restituisce codice di stato diverso da ERROR_SUCCESS dall'implementazione di questa funzione di callback, il processo di crittografia o decrittografia del flusso avrà esito negativo.

Codice restituito Descrizione
ERROR_SUCCESS
 La funzione ha avuto esito positivo.

Commenti

Impostare un puntatore a questa funzione di callback nel membro pfnStreamOutput della struttura NCRYPT_PROTECT_STREAM_INFO . Impostare un puntatore alla struttura nel parametro pStreamInfo delle funzioni NCryptStreamOpenToProtect o NCryptStreamOpenToUnprotect .

È possibile usare questo callback per elaborare ulteriormente i dati crittografati o decrittografati. Un uso comune della funzione consiste nel scrivere i dati su disco quando vengono ricevuti dall'API di protezione dei dati. I blocchi di dati crittografati o non crittografati vengono creati dalla funzione NCryptStreamUpdate .

Requisiti

Requisito Valore
Client minimo supportato Windows 8 [solo app desktop]
Server minimo supportato Windows Server 2012 [solo app desktop]
Piattaforma di destinazione Windows
Intestazione ncryptprotect.h

Vedi anche

Funzioni DPAPI CNG

NCRYPT_PROTECT_STREAM_INFO

NCryptStreamOpenToProtect

NCryptStreamOpenToUnprotect

NCryptStreamUpdate