IEnumCERTVIEWATTRIBUTE::GetValue-Methode (certview.h)
Die GetValue-Methode ruft den Wert des aktuellen Attributs in der Attribut-Enumerationssequenz ab.
Syntax
HRESULT GetValue(
[out] BSTR *pstrOut
);
Parameter
[out] pstrOut
Ein Zeiger auf einen BSTR-Typ , der den Wert des Attributs enthält.
Rückgabewert
C++
Wenn die Methode erfolgreich ist, gibt die Methode S_OK zurück, und pstrOut wird auf den Wert des aktuellen Attributs festgelegt.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 pstrOut. 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
Der Rückgabewert ist eine Zeichenfolge , die den Wert des aktuellen Attributs darstellt.Hinweise
Diese Methode wird verwendet, um die Daten im Attribut abzurufen, auf das derzeit von der Attribut-Enumerationssequenz verwiesen wird.
Wenn die Attributaufzählungssequenz nicht auf ein gültiges Attribut verweist, schlägt GetValue fehl. Verwenden Sie eine der folgenden Methoden, um durch die Enumeration zu navigieren:
- IEnumCERTVIEWATTRIBUTE::Reset: Wird an den Anfang der Enumerationssequenz verschoben.
- IEnumCERTVIEWATTRIBUTE::Next: Wechselt zum nächsten Attribut in der Enumerationssequenz.
- IEnumCERTVIEWATTRIBUTE::Skip: Überspringt eine angegebene Anzahl von Attributen.
Beispiele
BSTR bstrAttribValue = NULL;
// pEnumAttr is previously instantiated IEnumCERTVIEWATTRIBUTE object
hr = pEnumAttr->GetValue(&bstrAttribValue);
if (S_OK != hr)
printf("Failed call to GetValue - %x\n", hr);
else
printf("Attribute value is %ws\n",bstrAttribValue);
// free memory when done
if (NULL != bstrAttribValue)
SysFreeString(bstrAttribValue);
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 |