BCryptProcessMultiOperations function (bcrypt.h)

The BCryptProcessMultiOperations function processes a sequence of operations on a multi-object state.

Syntax

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

Parameters

hObject

BCRYPT_HANDLE [in, out]

A handle to a multi-object state, such as one created by the BCryptCreateMultiHash function.

operationType

BCRYPT_MULTI_OPERATION_TYPE [in]

One of the BCRYPT_OPERATION_TYPE_* values. Currently the only defined value is BCRYPT_OPERATION_TYPE_HASH. This value identifies the hObject parameter as a multi-hash object and the pOperations pointer as pointing to an array of BCRYPT_MULTI_HASH_OPERATION elements.

pOperations

PVOID [in]

A pointer to an array of operation command structures. For hashing, it is a pointer to an array of BCRYPT_MULTI_HASH_OPERATION structures.

cbOperations

ULONG [in]

The size, in bytes, of the pOperations array.

dwFlags

ULONG [in]

Specify a value of zero (0).

Return value

Returns a status code that indicates the success or failure of the function. If the method succeeds, it will return STATUS_SUCCESS. For other NTSTATUS values, see NTSTATUS Values.

Remarks

Each element of the pOperations array contains instructions for a particular computation to be performed on a single element of the multi-object state. The functional behavior of BCryptProcessMultiOperations is equivalent to performing, for each element in the multi-object state, the computations specified in the operations array for that element, one at a time, in order.

The relative order of two operations that operate on different elements of the array is not guaranteed. If an output buffer overlaps an input or output buffer the result is not deterministic.

Requirements

Requirement Value
Minimum supported client Windows 8.1 Update [desktop apps | UWP apps]
Minimum supported server Windows Server 2008 Update [desktop apps | UWP apps]
Target Platform Windows
Header bcrypt.h
Library Bcrypt.lib
DLL Bcrypt.dll

See also

BCRYPT_MULTI_HASH_OPERATION

BCryptCreateMultiHash