IEnumCERTVIEWATTRIBUTE::Next-Methode (certview.h)

Artikel
08/22/2023

Die Next-Methode wechselt zum nächsten Attribut in der Attributenumerationssequenz.

Syntax

HRESULT Next(
  [out] LONG *pIndex
);

Parameter

[out] pIndex

Ein Zeiger auf eine Variable, die den Indexwert des nächsten Attributs enthält, auf das verwiesen wird. Wenn keine weiteren Attribute aufgelistet werden müssen, wird diese Variable auf –1 festgelegt. Diese Methode schlägt fehl, wenn pIndexNULL ist.

Rückgabewert

C++

Wenn die Methode erfolgreich ist, gibt die Methode S_OK zurück, und auf das nächste Attribut wird jetzt von der Attributenumerationssequenz verwiesen. Wenn keine weiteren Attribute vorhanden sind, gibt die Methode S_FALSE zurück, und pIndex wird auf den Wert –1 festgelegt.

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 der Indexwert des Attributs, auf das jetzt von der Attributenumerationssequenz verwiesen wird. Wenn keine weiteren Attribute aufgelistet werden müssen, ist der Rückgabewert –1.

Hinweise

Nach erfolgreichem Abschluss dieser Methode kann über die folgenden Methoden auf den Attributnamen und den Wert zugegriffen werden:

Beispiele

LONG       Index;
HRESULT    hr;
BSTR       bstrAttribName = NULL;

// pEnumAttr is previously instantiated IEnumCERTVIEWATTRIBUTE object
while (S_OK == pEnumAttr->Next(&Index))
{
    // retrieve the attribute name
    hr = pEnumAttr->GetName(&bstrAttribName);
    if (FAILED(hr))
        printf("Failed GetName -  %x\n", hr );
    else
        printf("Attribute name: %ws\n", bstrAttribName);
}

// Free resources.
if (NULL != bstrAttribName)
    SysFreeString(bstrAttribName);

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