Funzione BCryptProcessMultiOperations (bcrypt.h)

Articolo
07/16/2024

La funzione BCryptProcessMultiOperations elabora una sequenza di operazioni su uno stato multioggetto.

Sintassi

NTSTATUS BCryptProcessMultiOperations(
  BCRYPT_HANDLE               hObject,
  BCRYPT_MULTI_OPERATION_TYPE operationType,
  PVOID                       pOperations,
  ULONG                       cbOperations,
  ULONG                       dwFlags
);

Parametri

hObject

BCRYPT_HANDLE[in, out]

Handle a uno stato multioggetto, ad esempio uno creato dalla funzione BCryptCreateMultiHash.

operationType

BCRYPT_MULTI_OPERATION_TYPE[in]

Uno dei valori BCRYPT_OPERATION_TYPE_* . Attualmente l'unico valore definito è BCRYPT_OPERATION_TYPE_HASH. Questo valore identifica il parametro hObject come oggetto multi-hash e il puntatore pOperations puntando a una matrice di elementi BCRYPT_MULTI_HASH_OPERATION.

pOperations

[in] PVOID

Puntatore a una matrice di strutture dei comandi dell'operazione. Per l'hashing, è un puntatore a una matrice di strutture BCRYPT_MULTI_HASH_OPERATION.

cbOperations

ULONG[in]

Dimensioni, in byte, della matrice pOperations.

dwFlags

ULONG[in]

Specificare un valore pari a zero (0).

Valore restituito

Restituisce un codice di stato che indica l'esito positivo o negativo della funzione. Se il metodo ha esito positivo, restituirà STATUS_SUCCESS. Per altri valori di NTSTATUS, vedere valori NTSTATUS.

Osservazioni

Ogni elemento della pOperations matrice contiene istruzioni per un determinato calcolo da eseguire su un singolo elemento dello stato multioggetto. Il comportamento funzionale di BCryptProcessMultiOperations equivale all'esecuzione, per ogni elemento nello stato multioggetto, i calcoli specificati nella matrice di operazioni per tale elemento, uno alla volta, in ordine.

L'ordine relativo di due operazioni che operano su elementi diversi della matrice non è garantito. Se un buffer di output si sovrappone a un buffer di input o di output, il risultato non è deterministico.

Fabbisogno

Requisito	Valore
client minimo supportato	Aggiornamento di Windows 8.1 [app desktop \| App UWP]
server minimo supportato	Windows Server 2008 Update [app desktop \| App UWP]
piattaforma di destinazione	Finestre
intestazione	bcrypt.h
libreria	Bcrypt.lib
dll	Bcrypt.dll

Vedere anche

BCRYPT_MULTI_HASH_OPERATION

BCryptCreateMultiHash

Condividi tramite