ICspInformation：：InitializeFromType 方法 (certenroll.h)

InitializeFromType 方法會從預設密碼編譯提供者初始化 物件。

語法

HRESULT InitializeFromType(
  [in]           X509ProviderType Type,
  [in, optional] IObjectId        *pAlgorithm,
  [in]           VARIANT_BOOL     MachineContext
);

參數

[in] Type

定義提供者類型的 X509ProviderType 列舉值。

• 如果您指定XCN_PROV_NONE並將 pAlgorithm 參數設定為 NULL 以外的值，則會使用預設的密碼編譯 API：新一代 (CNG) 提供者。
• 如果您指定XCN_PROV_NONE以外的值，並將 pAlgorithm 參數設定為 NULL，則會使用預設舊版密碼編譯服務提供者 (CSP) 。

[in, optional] pAlgorithm

代表演算法 OID 的 IObjectId 介面指標。 這個參數是選擇性的，而且可以是 NULL。 如需詳細資訊，請參閱 Type 參數。

[in] MachineContext

VARIANT_BOOL變數，指出要使用計算機或使用者內容來判斷指定提供者類型的預設提供者。 為計算機指定 VARIANT_TRUE ，併為使用者 指定VARIANT_FALSE 。

傳回值

如果函式成功，函式會傳回 S_OK。

如果函式失敗，它會傳回 指出錯誤的 HRESULT 值。 可能的值包括 (但不限於) 下表中的這些值。 如需常見錯誤碼的清單，請參閱 一般 HRESULT 值。

傳回碼/值	Description
HRESULT_FROM_WIN32 (ERROR_ALREADY_INITIALIZED)	對象已經初始化。

備註

InitializeFromType 方法會驗證指定的類型，並將其儲存在 Type 屬性中、擷取預設提供者，並在 ICspInformation 對象上設定下列屬性值：

• CspAlgorithms
• HasHardwareRandomNumberGenerator
• IsHardwareDevice
• IsRemovable
• IsSmartCard
• IsSoftwareDevice
• KeySpec
• LegacyCsp
• MaxKeyContainerNameLength
• 名稱
• 有效
• 版本

方法會將可用的演算法新增至 CspAlgorithms 屬性所傳回的 ICspAlgorithms 集合。 呼叫 InitializeFromName 方法，以從 CSP 名稱初始化 物件。

規格需求

需求	值
最低支援的用戶端	Windows Vista [僅限傳統型應用程式]
最低支援的伺服器	Windows Server 2008 [僅限傳統型應用程式]
目標平台	Windows
標頭	certenroll.h
Dll	CertEnroll.dll

另請參閱

ICspInformation