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 pbInput .

[in] dwFlags

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

Retornar valor

Retorna um código 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 dos 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.

Comentários

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
Cliente mínimo com suporte	Windows Vista [aplicativos da área de trabalho | Aplicativos UWP]
Servidor mínimo com suporte	Windows Server 2008 [aplicativos da área de trabalho | Aplicativos UWP]
Plataforma de Destino	Windows
Cabeçalho	bcrypt.h
Biblioteca	Bcrypt.lib
DLL	Bcrypt.dll