IEnumCERTVIEWROW::EnumCertViewAttribute-Methode (certview.h)
Die EnumCertViewAttribute-Methode ruft eine instance einer Attributenumerationssequenz für die aktuelle Zeile der Zeilenenumerationssequenz ab.
Syntax
HRESULT EnumCertViewAttribute(
[in] LONG Flags,
[out] IEnumCERTVIEWATTRIBUTE **ppenum
);
Parameter
[in] Flags
| C++ | Ein LONG-Wert . Muss Null sein. |
| VB | Ein Long-Wert . Muss Null sein. |
[out] ppenum
Ein Zeiger auf einen Zeiger vom Typ IEnumCERTVIEWATTRIBUTE . Nach erfolgreichem Abschluss dieser Methode wird ppenum auf einen Zeiger vom Typ IEnumCERTVIEWATTRIBUTE festgelegt.
Rückgabewert
C++
Wenn die Methode erfolgreich ist, gibt die Methode S_OK zurück.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
Der zurückgegebene Wert ist ein Attributenumerationssequenzobjekt.Hinweise
Die durch diesen Aufruf abgerufene Attributenumerationssequenz kann verwendet werden, um die Attribute aufzulisten, die dem Zertifikat in der aktuellen Zeile zugeordnet sind. Auf diese Enumeration kann über die Methoden der IEnumCERTVIEWATTRIBUTE-Schnittstelle zugegriffen werden.
Um auf eine andere Zeile zu verweisen, rufen Sie eine der folgenden Methoden auf, um durch die Zeilenenumerationssequenz zu navigieren:
- IEnumCERTVIEWROW::Reset: Wird an den Anfang der Enumerationssequenz verschoben.
- IEnumCERTVIEWROW::Next: Wechselt zur nächsten Zeile in der Enumerationssequenz.
- IEnumCERTVIEWROW::Skip: Überspringt eine angegebene Anzahl von Zeilen.
Beispiele
// pEnumRow is previously instantiated pointer to IEnumCERTVIEWROW
HRESULT hr;
LONG Index;
IEnumCERTVIEWATTRIBUTE * pEnumAttr = NULL;
// obtain enumerator for attributes
hr = pEnumRow->EnumCertViewAttribute(0, &pEnumAttr);
if (FAILED(hr))
{
printf("Failed EnumCertViewAttribute - %x\n", hr);
goto error;
}
// enumerate each attribute
while (S_OK == pEnumAttr->Next(&Index))
{
// Use this attribute as needed.
}
error:
// Free resources.
if (NULL != pEnumAttr)
pEnumAttr->Release();
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) | Nicht unterstützt |
| Unterstützte Mindestversion (Server) | Windows Server 2003 [nur Desktop-Apps] |
| Zielplattform | Windows |
| Kopfzeile | certview.h (include Certsrv.h) |
| Bibliothek | Certidl.lib |
| DLL | Certadm.dll |