ICertServerPolicy::EnumerateExtensionsSetup-Methode (certif.h)

  • Artikel

Die EnumerateExtensionsSetup-Methode initialisiert den internen Enumerationszeiger auf die erste Zertifikaterweiterung, die dem aktuellen Kontext zugeordnet ist.

Syntax

HRESULT EnumerateExtensionsSetup(
  [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 der aktuelle Kontext ist.

Um die Erweiterung abzurufen, rufen Sie die EnumerateExtensions-Methode auf. Der Aufruf von EnumerateExtensions ruft die erste Erweiterung ab und verschiebt den Index in die nächste Erweiterung, 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->EnumerateExtensionsSetup( 0 );
if (FAILED(hr))
{
    printf("Failed EnumerateExtensionsSetup [%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

Weitere Informationen

EnumerateExtensions

ICertServerPolicy

Setcontext