IX509CertificateRequest::GetInnerRequest メソッド (certenroll.h)

[アーティクル]
08/22/2023

GetInnerRequest メソッドは、入れ子になった要求オブジェクトを取得します。

構文

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

パラメーター

[in] Level

取得するデータの開発レベルを指定する InnerRequestLevel 列挙体の値。 LevelNext 値を使用して、入れ子になったレベルまたは LevelInn most 値を反復処理して、最も深く入れ子になった要求オブジェクトを取得できます。 PKCS #10 要求に LevelNext を指定することはできません。

[out] ppValue

入れ子になった要求を含む IX509CertificateRequest インターフェイスへのポインターを受け取る変数のアドレス。 Type プロパティを呼び出して、内部要求オブジェクトが PKCS #10 か CMC 要求かを判断します。次に QueryInterface を 呼び出して、適切なポインターを取得します。

戻り値

関数が成功した場合、関数は S_OKを返します。

関数が失敗した場合は、エラーを示す HRESULT 値を返します。有効な値を次の表に示しますが、これ以外にもあります。一般的なエラーコードの一覧については、「共通 HRESULT 値」を参照してください。

リターンコード/値	Description
CERTSRV_E_PROPERTY_EMPTY	LevelNext PKCS #10 要求の値を指定しました。

注釈

最上位レベルの要求オブジェクトには、PKCS #10、PKCS #7、または CMC 要求を指定できます。次の規則は、内部要求オブジェクトに適用されます。

PKCS #10 要求に内部要求オブジェクトを含めることはできません。
PKCS #7 要求には、PKCS #10 内部要求オブジェクトのみを含めることができます。
CMC 要求には、CMC または PKCS #10 内部要求オブジェクトを含めることができます。内部 CMC 要求を含む CMC 要求の場合、最終的な内部 PKCS #10 要求に到達する前に存在できる入れ子になったレベルの数に理論的な制限はありません。つまり、最上位レベルの CMC 要求には、内部 CMC 要求も含まれる内部 CMC 要求などを含めることができます。

要件

要件	値
サポートされている最小のクライアント	Windows Vista [デスクトップアプリのみ]
サポートされている最小のサーバー	Windows Server 2008 [デスクトップアプリのみ]
対象プラットフォーム	Windows
ヘッダー	certenroll.h
[DLL]	CertEnroll.dll