Función CryptSetOIDFunctionValue (wincrypt.h)

Artículo
08/27/2023

La función CryptSetOIDFunctionValue establece un valor para el tipo de codificación, el nombre de función, el OID y el nombre del valor especificados.

Sintaxis

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 el tipo de codificación que se va a coincidir. Actualmente, solo se usan X509_ASN_ENCODING y PKCS_7_ASN_ENCODING; sin embargo, en el futuro se pueden agregar tipos de codificación adicionales. Para hacer coincidir ambos tipos de codificación actuales, use:

X509_ASN_ENCODING | PKCS_7_ASN_ENCODING.

[in] pszFuncName

Nombre de la función para la que se está actualizando el tipo de codificación, el OID y el nombre del valor.

[in] pszOID

Si la palabra de orden superior del identificador de objeto (OID) es distinto de cero, pszOID es un puntero a una cadena OID como "2.5.29.1" o una cadena ASCII como "file". Si la palabra de orden superior del OID es cero, la palabra de orden bajo especifica el identificador entero que se va a usar como identificador de objeto.

[in] pwszValueName

Puntero a una cadena Unicode que contiene el nombre del valor que se va a establecer. Si un valor con este nombre aún no está presente, la función la crea.

[in] dwValueType

Especifica el tipo de información que se va a almacenar como datos del valor. Este parámetro puede ser uno de los valores siguientes.

Valor	Significado
REG_DWORD	Número de 32 bits.
REG_EXPAND_SZ	Cadena Unicode terminada en null que contiene referencias no expandidas a variables de entorno (por ejemplo, "%PATH%").
REG_MULTI_SZ	Matriz de cadenas Unicode terminadas en null, terminadas por dos caracteres NULL .
REG_SZ	Cadena Unicode terminada en null.

[in] pbValueData

Apunta a un búfer que contiene los datos que se van a almacenar para el nombre de valor especificado.

[in] cbValueData

Especifica el tamaño, en bytes, de la información a la que apunta el parámetro pbValueData . Si los datos son de tipo REG_SZ, REG_EXPAND_SZ o REG_MULTI_SZ, el tamaño debe incluir el carácter ancho NULL terminado.

Valor devuelto

Si la función se ejecuta correctamente, el valor devuelto es distinto de cero (TRUE).

Si se produce un error en la función, el valor devuelto es cero (FALSE).

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows XP [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows Server 2003 [solo aplicaciones de escritorio]
Plataforma de destino	Windows
Encabezado	wincrypt.h
Library	Crypt32.lib
Archivo DLL	Crypt32.dll

Consulte también

Funciones de compatibilidad con OID