Função CryptSetOIDFunctionValue (wincrypt.h)

Artigo
03/03/2024

A função CryptSetOIDFunctionValue define um valor para o tipo de codificação, o nome da função, o OID e o nome do valor especificados.

Sintaxe

BOOL CryptSetOIDFunctionValue(
  [in] DWORD      dwEncodingType,
  [in] LPCSTR     pszFuncName,
  [in] LPCSTR     pszOID,
  [in] LPCWSTR    pwszValueName,
  [in] DWORD      dwValueType,
  [in] const BYTE *pbValueData,
  [in] DWORD      cbValueData
);

Parâmetros

[in] dwEncodingType

Especifica o tipo de codificação a ser correspondido. Atualmente, apenas X509_ASN_ENCODING e PKCS_7_ASN_ENCODING estão sendo usados; no entanto, tipos de codificação adicionais podem ser adicionados no futuro. Para corresponder aos dois tipos de codificação atuais, use:

X509_ASN_ENCODING | PKCS_7_ASN_ENCODING.

[in] pszFuncName

Nome da função para a qual o tipo de codificação, o OID e o nome do valor estão sendo atualizados.

[in] pszOID

Se a palavra de alta ordem do OID (identificador de objeto ) for diferente de zero, pszOID será um ponteiro para uma cadeia de caracteres OID como "2.5.29.1" ou uma cadeia de caracteres ASCII , como "file". Se a palavra de alta ordem do OID for zero, a palavra de ordem baixa especificará o identificador inteiro a ser usado como o identificador de objeto.

[in] pwszValueName

Um ponteiro para uma cadeia de caracteres Unicode que contém o nome do valor a ser definido. Se um valor com esse nome ainda não estiver presente, a função o criará.

[in] dwValueType

Especifica o tipo de informação a ser armazenado como dados do valor. Esse parâmetro pode usar um dos valores a seguir.

Valor	Significado
REG_DWORD	Um número de 32 bits.
REG_EXPAND_SZ	Uma cadeia de caracteres Unicode terminada em nulo que contém referências não explicadas a variáveis de ambiente (por exemplo, "%PATH%").
REG_MULTI_SZ	Uma matriz de cadeias de caracteres Unicode terminadas em nulo, terminadas por dois caracteres NULL .
REG_SZ	Uma cadeia de caracteres Unicode terminada em nulo.

[in] pbValueData

Aponta para um buffer que contém os dados a serem armazenados para o nome do valor especificado.

[in] cbValueData

Especifica o tamanho, em bytes, das informações apontadas pelo parâmetro pbValueData . Se os dados forem do tipo REG_SZ, REG_EXPAND_SZ ou REG_MULTI_SZ, o tamanho deverá incluir o caractere largo NULL de terminação.

Retornar valor

Se a função for bem-sucedida, o valor retornado será diferente de zero (TRUE).

Se a função falhar, o valor retornado será zero (FALSE).

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Windows XP [somente aplicativos da área de trabalho]
Servidor mínimo com suporte	Windows Server 2003 [somente aplicativos da área de trabalho]
Plataforma de Destino	Windows
Cabeçalho	wincrypt.h
Biblioteca	Crypt32.lib
DLL	Crypt32.dll

Confira também

Funções de suporte do OID

Compartilhar via