Função BCryptProcessMultiOperations (bcrypt.h)

Artigo
07/16/2024

A função BCryptProcessMultiOperations processa uma sequência de operações em um estado de vários objetos.

Sintaxe

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

Parâmetros

hObject

BCRYPT_HANDLE[in, out]

Um identificador para um estado de vários objetos, como um criado pela função BCryptCreateMultiHash .

operationType

BCRYPT_MULTI_OPERATION_TYPE[in]

Um dos valores de BCRYPT_OPERATION_TYPE_*. Atualmente, o único valor definido é BCRYPT_OPERATION_TYPE_HASH. Esse valor identifica o parâmetro hObject como um objeto de vários hash e o ponteiro pOperations como apontando para uma matriz de elementos BCRYPT_MULTI_HASH_OPERATION.

pOperations

[in] PVOID

Um ponteiro para uma matriz de estruturas de comando de operação. Para hash, é um ponteiro para uma matriz de estruturas BCRYPT_MULTI_HASH_OPERATION.

cbOperations

[in] ULONG

O tamanho, em bytes, da matriz pOperations .

dwFlags

[in] ULONG

Especifique um valor igual a zero (0).

Valor de retorno

Retorna um código de status que indica o êxito ou a falha da função. Se o método for bem-sucedido, ele retornará STATUS_SUCCESS. Para obter outros valores de NTSTATUS , consulte valores NTSTATUS.

Observações

Cada elemento da matriz pOperations contém instruções para que uma computação específica seja executada em um único elemento do estado de vários objetos. O comportamento funcional de BCryptProcessMultiOperations é equivalente a executar, para cada elemento no estado de vários objetos, os cálculos especificados na matriz de operações para esse elemento, um de cada vez, em ordem.

A ordem relativa de duas operações que operam em diferentes elementos da matriz não é garantida. Se um buffer de saída sobrepor um buffer de entrada ou saída, o resultado não será determinístico.

Requisitos

Requisito	Valor
de cliente com suporte mínimo	Atualização do Windows 8.1 [aplicativos da área de trabalho \| Aplicativos UWP]
servidor com suporte mínimo	Atualização do Windows Server 2008 [aplicativos da área de trabalho \| Aplicativos UWP]
da Plataforma de Destino	Windows
cabeçalho	bcrypt.h
biblioteca	Bcrypt.lib
de DLL	Bcrypt.dll

Consulte também

BCRYPT_MULTI_HASH_OPERATION

BCryptCreateMultiHash

Compartilhar via