Función CryptCATPutAttrInfo (mscat.h)

  • Artículo

[La función CryptCATPutAttrInfo 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 CryptCATPutAttrInfo asigna memoria para un atributo y la agrega a un miembro del catálogo.

Sintaxis

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

Parámetros

[in] hCatalog

Identificador del catálogo obtenido de la función CryptCATOpen o CryptCATHandleFromStore .

[in] pCatMember

Puntero a una estructura CRYPTCATMEMBER que contiene el miembro de catálogo.

[in] pwszReferenceTag

Puntero a una cadena terminada en null que contiene 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_DATABASE64 o CRYPTCAT_ATTR_DATAASCII.

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

Cuando se ejecuta correctamente, esta función devuelve un puntero a una estructura CRYPTCATATTRIBUTE que contiene el atributo asignado. 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 de error adicional mediante una llamada 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

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