CryptCATEnumerateMember-Funktion (mscat.h)

[Die CryptCATEnumerateMember-Funktion ist für die Verwendung in den Betriebssystemen verfügbar, die im Abschnitt Anforderungen angegeben sind. Sie kann in nachfolgenden Versionen geändert oder nicht verfügbar sein.]

Die Funktion CryptCATEnumerateMember listet die Elemente eines Katalogs auf.

Syntax

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

Parameter

[in] hCatalog

Das Handle des Katalogs, der die aufzuzählenden Member enthält. Dieser Wert darf nicht NULL sein.

[in] pPrevMember

Ein Zeiger auf eine CRYPTCATMEMBER-Struktur , die angibt, welches Element des Katalogs zuletzt abgerufen wurde. Wenn dieser Parameter NULL ist, ruft diese Funktion das erste Element des Katalogs ab.

Rückgabewert

Diese Funktion gibt einen Zeiger auf eine CRYPTCATMEMBER-Struktur zurück, die das nächste Element des Katalogs darstellt. Wenn es keine weiteren Elemente im Katalog gibt, die aufgelistet werden müssen, gibt diese Funktion NULL zurück.

Hinweise

Geben Sie weder den zurückgegebenen Zeiger noch einen der Elemente frei, auf die der zurückgegebene Zeiger verweist.

Beispiele

Das folgende Pseudocodebeispiel zeigt, wie Sie diese Funktion verwenden, um alle Member eines Katalogs aufzulisten.

CRYPTCATMEMBER *pMember = NULL;

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

Anforderungen

Weitere Informationen

CRYPTCATMEMBER