Condividi tramite

Funzione CryptCATPutCatAttrInfo (mscat.h)

  • Articolo

[La funzione CryptCATPutCatAttrInfo è disponibile per l'uso nei sistemi operativi specificati nella sezione Requisiti. Può essere modificato o non disponibile nelle versioni successive.

La funzione CryptCATCatAttrInfo alloca memoria per un attributo di file di catalogo e la aggiunge al catalogo.

Sintassi

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

Parametri

[in] hCatalog

Handle al catalogo ottenuto dalle funzioni CryptCATOpen o CryptCATHandleFromStore .

[in] pwszReferenceTag

Puntatore a una stringa con terminazione null per il nome dell'attributo.

[in] dwAttrTypeAndAction

Valore che rappresenta una combinazione bit per bit dei flag seguenti. Il chiamante deve specificare almeno CRYPTCAT_ATTR_DATAASCII o CRYPTCAT_ATTR_DATABASE64.

Valore Significato
CRYPTCAT_ATTR_AUTHENTICATED
0x10000000
 L'attributo è autenticato.
CRYPTCAT_ATTR_UNAUTHENTICATED
0x20000000
 L'attributo non è autenticato.
CRYPTCAT_ATTR_NAMEASCII
0x00000001
 L'attributo è una stringa ASCII.
CRYPTCAT_ATTR_NAMEOBJID
0x00000002
 L'attributo è un identificatore dell'oggetto crittografico (OID).
CRYPTCAT_ATTR_DATAASCII
0x00010000
 L'attributo contiene caratteri ASCII semplici che non devono essere decodificati.
CRYPTCAT_ATTR_DATABASE64
0x00020000
 L'attributo è in formato base 64.
CRYPTCAT_ATTR_DATAREPLACE
0x00040000
 L'attributo sostituisce il valore per un attributo esistente.

[in] cbData

Valore che specifica il numero di byte nel buffer pbData .

[in] pbData

Puntatore a un buffer di memoria contenente il valore dell'attributo.

Valore restituito

Puntatore a una struttura CRYPTCATATTRIBUTE contenente l'attributo del catalogo. Il chiamante non deve liberare questo puntatore o uno dei relativi membri.

Se questa funzione restituisce NULL, è possibile ottenere informazioni aggiuntive sull'errore chiamando la funzione GetLastError . GetLastError restituirà uno dei codici di errore seguenti.

Codice restituito Descrizione
ERROR_INVALID_PARAMETER
 Uno o più parametri non sono validi.
ERROR_NOT_ENOUGH_MEMORY
 Il sistema operativo ha esaurito la memoria durante l'operazione.

Requisiti

   
Client minimo supportato Windows XP [solo app desktop]
Server minimo supportato Windows Server 2003 [solo app desktop]
Piattaforma di destinazione Windows
Intestazione mscat.h
Libreria Wintrust.lib
DLL Wintrust.dll