Compartilhar via


Função BCryptSetProperty (bcrypt.h)

A função BCryptSetProperty define o valor de uma propriedade nomeada para um objeto CNG.

Sintaxe

NTSTATUS BCryptSetProperty(
  [in, out] BCRYPT_HANDLE hObject,
  [in]      LPCWSTR       pszProperty,
  [in]      PUCHAR        pbInput,
  [in]      ULONG         cbInput,
  [in]      ULONG         dwFlags
);

Parâmetros

[in, out] hObject

Um identificador que representa o objeto CNG para o qual definir o valor da propriedade.

[in] pszProperty

Um ponteiro para uma cadeia de caracteres Unicode terminada em nulo que contém o nome da propriedade a ser definida. Esse pode ser um dos identificadores de propriedade primitiva de criptografia predefinidos ou um identificador de propriedade personalizado.

[in] pbInput

O endereço de um buffer que contém o novo valor da propriedade. O parâmetro cbInput contém o tamanho desse buffer.

[in] cbInput

O tamanho, em bytes, do buffer de de pbInput.

[in] dwFlags

Um conjunto de sinalizadores que modificam o comportamento dessa função. Nenhum sinalizador é definido para essa função.

Valor de retorno

Retorna um código de status que indica o êxito ou a falha da função.

Os códigos de retorno possíveis incluem, mas não se limitam a, o seguinte.

Código de retorno Descrição
STATUS_SUCCESS
A função foi bem-sucedida.
STATUS_INVALID_HANDLE
O identificador no parâmetro hObject não é válido.
STATUS_INVALID_PARAMETER
Um ou mais parâmetros não são válidos.
STATUS_NOT_SUPPORTED
A propriedade nomeada especificada pelo parâmetro pszProperty não tem suporte ou é somente leitura.

Observações

Dependendo de quais modos de processador um provedor dá suporte, BCryptSetProperty pode ser chamado do modo de usuário ou do modo kernel. Os chamadores do modo kernel podem ser executados em PASSIVE_LEVELIRQL ou DISPATCH_LEVEL IRQL. Se o nível IRQL atual for DISPATCH_LEVEL, todos os ponteiros passados para BCryptSetProperty deverão se referir à memória nãopagada (ou bloqueada). Se o objeto especificado no parâmetro hObject for um identificador, ele deverá ter sido aberto usando o sinalizador BCRYPT_PROV_DISPATCH.

Para chamar essa função no modo kernel, use Cng.lib, que faz parte do DDK (Driver Development Kit). Windows Server 2008 e Windows Vista: Para chamar essa função no modo kernel, use Ksecdd.lib.

Ao definir o valor da propriedade BCRYPT_CHAINING_MODE, o parâmetro pbInput não é associado por cbInput. O chamador precisa garantir que uma cadeia de caracteres Unicode terminada em nulo válida seja fornecida.

Requisitos

Requisito Valor
de cliente com suporte mínimo Windows Vista [aplicativos da área de trabalho | Aplicativos UWP]
servidor com suporte mínimo 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