ICertServerExit::EnumerateAttributes-Methode (certif.h)

Artikel
02/23/2024

Die EnumerateAttributes-Methode gibt den Namen des Attributs der nächsten Anforderung im aktuellen Kontext zurück und erhöht dann den internen Zeiger auf das folgende Attribut.

Vor dem Aufruf von EnumerateAttributes ruft eine Anwendung ICertServerExit::EnumerateAttributesSetup auf. Wenn die Aufzählung abgeschlossen ist, ruft eine Anwendung ICertServerExit::EnumerateAttributesClose auf.

Syntax

HRESULT EnumerateAttributes(
  [out] BSTR *pstrAttributeName
);

Parameter

[out] pstrAttributeName

Ein Zeiger auf den aufgezählten Attributnamen.

Rückgabewert

C++

Wenn die Methode erfolgreich ist, gibt die Methode S_OK zurück, und *pstrAttributeName wird auf den BSTR festgelegt, der den Namen des aufgezählten Attributs enthält. Ein Wert von S_FALSE wird zurückgegeben, wenn das letzte Attribut bereits aufgelistet wurde.

Um diese Methode zu verwenden, erstellen Sie eine Variable vom Typ BSTR , legen Sie die Variable gleich NULL fest, und übergeben Sie die Adresse dieser Variablen als pstrAttributeName.

Wenn Sie die Verwendung des BSTR abgeschlossen haben, geben Sie ihn frei, indem Sie die SysFreeString-Funktion aufrufen.

Wenn die Methode fehlschlägt, gibt sie einen HRESULT-Wert zurück, der den Fehler angibt. Eine Liste allgemeiner Fehlercodes finden Sie unter Allgemeine HRESULT-Werte.

VB

Gibt eine Zeichenfolge zurück, die den Namen des aufgezählten Attributs enthält, oder eine leere Zeichenfolge, wenn das letzte Attribut bereits aufgelistet wurde.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Nicht unterstützt
Unterstützte Mindestversion (Server)	Windows Server 2003 [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	certif.h (include Certsrv.h)
Bibliothek	Certidl.lib
DLL	Certcli.dll