ICEnroll4::enumPendingRequest メソッド (xenroll.h)

  • [アーティクル]

[このメソッドは、Windows Server 2008 および Windows Vista では使用できなくなりました。

enumPendingRequest メソッドは、保留中の証明書要求を列挙し、それぞれから指定されたプロパティを取得します。

このメソッドは、 ICEnroll4 インターフェイスで最初に定義されました。

構文

HRESULT enumPendingRequest(
  [in]  LONG    lIndex,
  [in]  LONG    lDesiredProperty,
  [out] VARIANT *pvarProperty
);

パラメーター

[in] lIndex

プロパティを取得する保留中の要求の序数位置を指定します。 最初の要求に 0 を指定します。

[in] lDesiredProperty

取得するプロパティの識別子。 このパラメーターには、次の値のいずれかを指定できます。

値 意味
XEPR_CADNS
 証明機関 (CA) の DNS 名。
XEPR_CAFRIENDLYNAME
 CA の表示名。
XEPR_CANAME
 CA の名前。
XEPR_HASH
 要求のハッシュ値。
XEPR_REQUESTID
 証明書要求 ID。

[out] pvarProperty

取得したプロパティの値を受け取る VARIANT へのポインター。

VARIANT の使用が完了したら、VariantClear 関数を呼び出して解放します。

戻り値

C++

メソッドが成功した場合、メソッドは S_OKを返します。

メソッドが失敗した場合は、エラーを示す HRESULT 値を返します。 一般的なエラー コードの一覧については、「 共通の HRESULT 値」を参照してください。

lDesiredProperty に次の値が指定されている場合、このメソッドはE_NOTIMPLを返します。

  • XEPR_DATE
  • XEPR_V1TEMPLATENAME
  • XEPR_V2TEMPLATEOID
  • XEPR_VERSION

lDesiredProperty に他の値を指定すると、このメソッドはE_INVALIDARGを返します。

VB

保留中の要求のプロパティを含む バリアント型 (Variant) の 値を取得します。

注釈

このメソッドは、証明書登録コントロールがスクリプト化されたコントロールとして実行されるときに無効になります。

要件

要件 値
サポートされている最小のクライアント Windows XP (デスクトップ アプリのみ)
サポートされている最小のサーバー Windows Server 2003 (デスクトップ アプリのみ)
対象プラットフォーム Windows
ヘッダー xenroll.h
Library Uuid.lib
[DLL] Xenroll.dll