Freigeben über


IX509CertificateRequest::GetInnerRequest-Methode (certenroll.h)

Die GetInnerRequest-Methode ruft ein geschachteltes Anforderungsobjekt ab.

Syntax

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

Die Parameter

[in] Level

Ein Wert einer InnerRequestLevel-Aufzählung , die die Abvelopmentebene der abzurufenden Daten angibt. Sie können den LevelNext-Wert verwenden, um die geschachtelten Ebenen oder den LevelInnermost-Wert zu durchlaufen, um das tief geschachtelte Anforderungsobjekt abzurufen. Sie können "LevelNext " für eine PKCS #10-Anforderung nicht 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 festzustellen, ob es sich bei dem inneren Anforderungsobjekt um eine PKCS #10- oder eine CMC-Anforderung handelt. 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, wird ein HRESULT-Wert zurückgegeben, der den Fehler angibt. Mögliche Werte sind die Werte in der folgenden Tabelle, sind jedoch nicht beschränkt. Eine Liste allgemeiner Fehlercodes finden Sie unter "Allgemeine HRESULT-Werte".

Zurückgeben von Code/Wert Description
CERTSRV_E_PROPERTY_EMPTY
Sie haben einen Wert der LevelNext PKCS #10-Anforderung angegeben.

Bemerkungen

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 darf kein inneres Anforderungsobjekt enthalten.
  • Eine PKCS #7-Anforderung kann nur ein inneres PKCS #10-Anforderungsobjekt enthalten.
  • Eine CMC-Anforderung kann ein CMC- oder ein PKCS #10 inneres Anforderungsobjekt enthalten. Für eine CMC-Anforderung, die eine innere CMC-Anforderung enthält, gibt es keine theoretische Grenze für die Anzahl der geschachtelten Ebenen, die vorhanden sein können, bevor die endgültige innere PKCS #10-Anforderung erreicht wird. Das heißt, eine CMC-Anforderung auf oberster Ebene kann eine innere CMC-Anforderung enthalten, die auch eine innere CMC-Anforderung enthält usw.

Anforderungen

Anforderung Wert
Mindestens unterstützter Client Windows Vista [nur Desktop-Apps]
Mindestanforderungen für unterstützte Server Windows Server 2008 [Nur Desktop-Apps]
Zielplattform Fenster
Header certenroll.h
DLL CertEnroll.dll

Siehe auch

IX509CertificateRequest

IX509CertificateRequestCertificate

IX509CertificateRequestCmc

IX509CertificateRequestPkcs10

IX509CertificateRequestPkcs7

IX509SignatureInformation