IX509CertificateRequest::GetInnerRequest-Methode (certenroll.h)

Artikel
02/23/2024

Die GetInnerRequest-Methode ruft ein geschachteltes Anforderungsobjekt ab.

Syntax

HRESULT GetInnerRequest(
  [in]  InnerRequestLevel       Level,
  [out] IX509CertificateRequest **ppValue
);

Parameter

[in] Level

Ein Wert einer InnerRequestLevel-Enumeration , der die Umhüllenebene der abzurufenden Daten angibt. Sie können den LevelNext-Wert verwenden, um die geschachtelten Ebenen oder den LevelInnermost-Wert zu durchlaufen, um das am tiefsten geschachtelte Anforderungsobjekt abzurufen. Sie können LevelNext nicht für eine PKCS #10-Anforderung angeben.

[out] ppValue

Adresse einer Variablen, die einen Zeiger auf eine IX509CertificateRequest-Schnittstelle empfängt, die die geschachtelte Anforderung enthält. Rufen Sie die Type-Eigenschaft auf, um zu ermitteln, ob das innere Anforderungsobjekt eine PKCS #10- oder eine CMC-Anforderung ist. Rufen Sie dann QueryInterface auf, um den entsprechenden Zeiger abzurufen.

Rückgabewert

Wenn die Funktion erfolgreich ist, gibt die Funktion S_OK zurück.

Wenn die Funktion fehlschlägt, gibt sie einen HRESULT-Wert zurück, der den Fehler angibt. Mögliches Werte (aber nicht die Einzigen) sind die in der folgenden Tabelle. Eine Liste allgemeiner Fehlercodes finden Sie unter Allgemeine HRESULT-Werte.

Rückgabecode/-wert	BESCHREIBUNG
CERTSRV_E_PROPERTY_EMPTY	Sie haben einen Wert von LevelNext PKCS #10 request angegeben.

Hinweise

Ein Anforderungsobjekt der obersten Ebene kann eine PKCS #10-, PKCS #7- oder CMC-Anforderung sein. Die folgenden Regeln gelten für innere Anforderungsobjekte:

Eine PKCS #10-Anforderung kann kein inneres Anforderungsobjekt enthalten.
Eine PKCS #7-Anforderung kann nur ein PKCS #10-Inneres Anforderungsobjekt enthalten.
Eine CMC-Anforderung kann ein CMC- oder ein PKCS #10-Objekt für eine innere Anforderung enthalten. Für eine CMC-Anforderung, die eine innere CMC-Anforderung enthält, gibt es keine theoretische Begrenzung für die Anzahl geschachtelter Ebenen, die vorhanden sein können, bevor die endgültige innere PKCS #10-Anforderung erreicht wird. Das heißt, eine CMC-Anforderung der obersten Ebene kann eine innere CMC-Anforderung enthalten, die auch eine innere CMC-Anforderung enthält usw.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows Vista [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2008 [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	certenroll.h
DLL	CertEnroll.dll