IX509PrivateKey::get_ProviderType メソッド (certenroll.h)

ProviderType プロパティは、秘密キーに関連付けられている暗号化プロバイダーの種類を指定または取得します。 このプロパティは、入力と出力の両方に対して Web 対応です。

このプロパティは読み取り/書き込み可能です。

構文

HRESULT get_ProviderType(
  X509ProviderType *pValue
);

パラメーター

pValue

戻り値

なし

解説

このプロパティを使用すると、特定のプロバイダーの種類に対して既定のプロバイダーを強制的に使用できます。 たとえば、PROV_RSA_SCHANNEL プロバイダーを使用するには、このプロパティを XCN_PROV_RSA_SCHANNEL X509ProviderType 列挙値に設定し、ProviderName プロパティの値を指定しないでください。

このプロパティを設定すると、指定した ProviderType 値と一致するように次のプロパティが自動的に設定されます。

• KeySpec
• LegacyCsp

これらのプロパティは、次の方法で設定されます。

• ProviderType が XCN_PROV_NONE に設定されている場合:
  • LegacyCsp プロパティは VARIANT_FALSE に設定されます。
  • KeySpec プロパティは、XCN_AT_NONEに設定されます。
• ProviderType が XCN_PROV_NONE に設定されていない場合:
  • LegacyCsp プロパティは、VARIANT_TRUEに設定されます。
  • KeySpec プロパティは、現在の値がXCN_AT_NONEされている場合にXCN_AT_SIGNATUREに設定されます。

以前に指定した ProviderName は ProviderType プロパティを設定しても影響を受けないため、ProviderName プロパティと矛盾する ProviderType を設定すると、未定義の動作が発生し、秘密キーを作成または開くときに失敗する可能性があります。 ProviderType プロパティは、上記で説明したように、指定した型に対して既定のプロバイダーの使用を強制する場合にのみ設定することをお勧めします。

要件

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

こちらもご覧ください

IX509PrivateKey