共用方式為

ICEnroll4：：enumPendingRequest 方法 (xenroll.h)

  • 發行項

[從 Windows Server 2008 和 Windows Vista 起，這個方法已不再可供使用。]

enumPendingRequest 方法會列舉擱置的憑證要求，並從每個要求擷取指定的屬性。

這個方法最初是在 ICEnroll4 介面中定義。

語法

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

參數

[in] lIndex

指定要擷取其屬性之擱置要求的序數位置。 為第一個要求指定零。

[in] lDesiredProperty

要擷取之屬性的標識碼。 此參數可以是下列其中一個值。

值 意義
XEPR_CADNS
 證書頒發機構單位的 DNS 名稱 (CA) 。
XEPR_CAFRIENDLYNAME
 CA 的顯示名稱。
XEPR_CANAME
 CA 的名稱。
XEPR_HASH
 要求的哈希值。
XEPR_REQUESTID
 憑證要求標識碼。

[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
程式庫 Uuid.lib
Dll Xenroll.dll