Compartir a través de

Función CryptCATPutCatAttrInfo (mscat.h)

  • Artículo

[La función CryptCATPutCatAttrInfo está disponible para su uso en los sistemas operativos especificados en la sección Requisitos. Puede modificarse o no estar disponible en versiones posteriores.

La función CryptCATPutCatAttrInfo asigna memoria para un atributo de archivo de catálogo y la agrega al catálogo.

Sintaxis

CRYPTCATATTRIBUTE * CryptCATPutCatAttrInfo(
  [in] HANDLE hCatalog,
  [in] LPWSTR pwszReferenceTag,
  [in] DWORD  dwAttrTypeAndAction,
  [in] DWORD  cbData,
  [in] BYTE   *pbData
);

Parámetros

[in] hCatalog

Identificador del catálogo obtenido de las funciones CryptCATOpen o CryptCATHandleFromStore .

[in] pwszReferenceTag

Puntero a una cadena terminada en null para el nombre del atributo.

[in] dwAttrTypeAndAction

Valor que representa una combinación bit a bit de las marcas siguientes. El autor de la llamada debe especificar al menos CRYPTCAT_ATTR_DATAASCII o CRYPTCAT_ATTR_DATABASE64.

Valor Significado
CRYPTCAT_ATTR_AUTHENTICATED
0x10000000
 El atributo se autentica.
CRYPTCAT_ATTR_UNAUTHENTICATED
0x20000000
 El atributo no está autenticado.
CRYPTCAT_ATTR_NAMEASCII
0x00000001
 El atributo es una cadena ASCII.
CRYPTCAT_ATTR_NAMEOBJID
0x00000002
 El atributo es un identificador de objeto criptográfico (OID).
CRYPTCAT_ATTR_DATAASCII
0x00010000
 El atributo contiene caracteres ASCII simples que no se deben descodificar.
CRYPTCAT_ATTR_DATABASE64
0x00020000
 El atributo está en formato base 64.
CRYPTCAT_ATTR_DATAREPLACE
0x00040000
 El atributo reemplaza el valor de un atributo existente.

[in] cbData

Valor que especifica el número de bytes en el búfer pbData .

[in] pbData

Puntero a un búfer de memoria que contiene el valor del atributo.

Valor devuelto

Puntero a una estructura CRYPTCATATTRIBUTE que contiene el atributo de catálogo. El autor de la llamada no debe liberar este puntero ni ninguno de sus miembros.

Si esta función devuelve NULL, se puede obtener información adicional de error llamando a la función GetLastError . GetLastError devolverá uno de los siguientes códigos de error.

Código devuelto Descripción
ERROR_INVALID_PARAMETER
 Uno o varios de los parámetros no son válidos.
ERROR_NOT_ENOUGH_MEMORY
 El sistema operativo se quedó sin memoria durante la operación.

Requisitos

   
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 mscat.h
Library Wintrust.lib
Archivo DLL Wintrust.dll