Función CryptCATPutAttrInfo (mscat.h)
[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 |
---|---|
|
El atributo se autentica. |
|
El atributo no está autenticado. |
|
El atributo es una cadena ASCII. |
|
El atributo es un identificador de objeto criptográfico (OID). |
|
El atributo contiene caracteres ASCII simples que no se deben descodificar. |
|
El atributo está en formato base 64. |
|
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 |
---|---|
|
Uno o varios de los parámetros no son válidos. |
|
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 |