Funzione CryptCATEnumerateMember (mscat.h)

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

La funzione CryptCATEnumerateMember enumera i membri di un catalogo.

Sintassi

CRYPTCATMEMBER * CryptCATEnumerateMember(
  [in] HANDLE         hCatalog,
  [in] CRYPTCATMEMBER *pPrevMember
);

Parametri

[in] hCatalog

Handle del catalogo che contiene i membri da enumerare. Questo valore non può essere NULL.

[in] pPrevMember

Puntatore a una struttura CRYPTCATMEMBER che identifica il membro del catalogo recuperato per ultimo. Se questo parametro è NULL, questa funzione recupererà il primo membro del catalogo.

Valore restituito

Questa funzione restituisce un puntatore a una struttura CRYPTCATMEMBER che rappresenta il membro successivo del catalogo. Se non sono presenti altri membri nel catalogo da enumerare, questa funzione restituisce NULL.

Commenti

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

Esempio

Nell'esempio di pseudocodice seguente viene illustrato come usare questa funzione per enumerare tutti i membri di un catalogo.

CRYPTCATMEMBER *pMember = NULL;

for(pMember = CryptCATEnumerateMember(hCatalog, pMember); 
    NULL != pMember; 
    pMember = CryptCATEnumerateMember(hCatalog, pMember))
{
   // Use the catalog member.
}

Requisiti

Vedi anche

CRYPTCATMEMBER