ICertServerPolicy::EnumerateAttributesSetup-Methode (certif.h)

Artikel
02/23/2024

Die EnumerateAttributesSetup-Methode initialisiert den internen Enumerationszeiger auf das erste Anforderungsattribut , das dem aktuellen Kontext zugeordnet ist.

Syntax

HRESULT EnumerateAttributesSetup(
  [in] LONG Flags
);

Parameter

[in] Flags

Dieser Parameter ist reserviert und muss auf null festgelegt werden.

Rückgabewert

VB

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.

Hinweise

Die SetContext-Methode muss vor dem Aufrufen dieser Methode aufgerufen werden. Der Aufruf von SetContext gibt an, welche Anforderung als aktueller Kontext verwendet werden soll.

Rufen Sie zum Abrufen des Attributs die EnumerateAttributes-Methode auf. Der Aufruf von EnumerateAttributes ruft das erste Attribut ab und verschiebt den Index in das nächste Attribut, sofern vorhanden.

Beispiele

// Set the context. The value nContext (long) would be the same
// as the context parameter in ICertPolicy::VerifyRequest.
// hr is defined as an HRESULT.
// pCertServerPolicy has been used to call SetContext previously.
hr = pCertServerPolicy->SetContext(nContext);
if (FAILED(hr))
{
    printf("Failed SetContext [%x]\n", hr);
    goto error;
}

// Setup the enumeration.
hr = pCertServerPolicy->EnumerateAttributesSetup(0);
if (FAILED(hr))
{
    printf("Failed EnumerateAttributesSetup [%x]\n", hr);
    goto error;
}

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