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
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) | Windows XP [nur Desktop-Apps] |
| Unterstützte Mindestversion (Server) | Windows Server 2003 [nur Desktop-Apps] |
| Zielplattform | Windows |
| Kopfzeile | mscat.h |
| Bibliothek | Wintrust.lib |
| DLL | Wintrust.dll |