Funzione di callback PFNCryptStreamOutputCallback (ncryptprotect.h)
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.
[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 |
|---|---|
|
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 |