Funzione CryptCATGetAttrInfo (mscat.h)

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

La funzione CryptCATGetAttrInfo recupera informazioni su un attributo di un membro di un catalogo.

Sintassi

CRYPTCATATTRIBUTE * CryptCATGetAttrInfo(
  [in] HANDLE         hCatalog,
  [in] CRYPTCATMEMBER *pCatMember,
  [in] LPWSTR         pwszReferenceTag
);

Parametri

[in] hCatalog

Handle del catalogo contenente il membro per cui recuperare le informazioni sull'attributo. Questo handle viene ottenuto chiamando la funzione CryptCATOpen . Questo parametro è obbligatorio e non può essere NULL.

[in] pCatMember

Puntatore a una struttura CRYPTCATMEMBER che rappresenta il membro per cui recuperare le informazioni sull'attributo. Questa operazione può essere ottenuta chiamando la funzione CryptCATGetMemberInfo . Questo parametro è obbligatorio e non può essere NULL.

[in] pwszReferenceTag

Puntatore a una stringa Unicode con terminazione Null contenente il nome dell'attributo per cui recuperare le informazioni. Questo parametro è obbligatorio e non può essere NULL.

Valore restituito

Questa funzione restituisce un puntatore a una struttura CRYPTCATATTRIBUTE che contiene le informazioni sull'attributo. Se la funzione ha esito negativo, restituisce NULL.

Importante Non liberare il puntatore restituito né nessuno dei membri a cui punta il puntatore restituito.

 

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
CRYPT_E_NOT_FOUND	Impossibile trovare il membro o l'attributo .
ERROR_INVALID_PARAMETER	Uno o più parametri non sono validi.

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

Vedi anche

CRYPTCATATTRIBUTE

CRYPTCATMEMBER

CryptCATGetMemberInfo

CryptCATOpen