ICertServerPolicy::EnumerateAttributes-Methode (certif.h)
Die EnumerateAttributes-Methode ruft den Namen des aktuellen Attributs ab und verschiebt den internen Enumerationszeiger auf das nächste Attribut.
Syntax
HRESULT EnumerateAttributes(
[out] BSTR *pstrAttributeName
);
Parameter
[out] pstrAttributeName
Ein Zeiger auf den Attributnamen.
Rückgabewert
C++
Wenn die Methode erfolgreich ist, gibt die Methode S_OK zurück, und der pstrAttributeName-Parameter wird auf einen BSTR festgelegt, der den Namen des Attributs enthält. Der Wert S_FALSE wird zurückgegeben, wenn das letzte Attribut bereits aufgezählt wurde.Um diese Methode zu verwenden, erstellen Sie eine Variable vom BSTR-Typ , legen Sie die Variable auf NULL fest, und übergeben Sie dann 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 Attributs enthält, oder eine leere Zeichenfolge, wenn das letzte Attribut bereits aufgezählt wurde.Hinweise
Rufen Sie vor dem ersten Aufruf der EnumerateAttributes-Methode die EnumerateAttributesSetup-Methode auf, um den Enumerationszeiger auf das erste Attribut zu initialisieren.
Rufen Sie nach Abschluss der Aufzählung auf.
die EnumerateAttributesClose-Methode , um ressourcen freizugeben, die von den Enumerationsaufrufen verwendet werden.
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 |