ICspStatuses::get_ItemByProvider メソッド (certenroll.h)
ItemByProvider プロパティは、入力時に指定されたプロバイダーと同じ名前を持つ ICspStatus オブジェクトを取得しますが、別の目的のキーの使用をサポートするアルゴリズムを識別します。
このプロパティは読み取り専用です。
構文
HRESULT get_ItemByProvider(
ICspStatus *pCspStatus,
ICspStatus **ppValue
);
パラメーター
pCspStatus
ppValue
戻り値
なし
解説
ItemByProvider プロパティは、入力プロバイダーの名前と一致するが、別の X509KeySpec 列挙値に関連付けられている ICspStatus オブジェクトを取得します。 たとえば、入力プロバイダーの KeySpec 値が XCN_AT_KEYEXCHANGE の場合、 ItemByProvider プロパティは、同じプロバイダーの ICspStatus オブジェクトを検索しようとしますが、 KeySpec 値は XCN_AT_SIGNATURE。
KeySpec プロパティはレガシ プロバイダーにのみ関連付けられているため、Cryptography API: Next Generation (CNG) プロバイダーを指定した場合、ItemByProvider プロパティは入力したのと同じ ICspStatus オブジェクトを返します。
このプロパティを使用してコレクションを反復処理するには、次の手順を実行します。
- IX509CertificateRequestPkcs10 インターフェイスで GetCspStatuses メソッドまたは CspStatuses プロパティを呼び出して、ICspStatuses コレクションを取得します。
- ItemByIndex プロパティを呼び出して、コレクションを反復処理します。
- 関心のあるプロバイダーを含む取得した ICspStatus 要素ごとに、 ItemByProvider を呼び出します。
要件
要件 | 値 |
---|---|
サポートされている最小のクライアント | Windows Vista [デスクトップ アプリのみ] |
サポートされている最小のサーバー | Windows Server 2008 [デスクトップ アプリのみ] |
対象プラットフォーム | Windows |
ヘッダー | certenroll.h |
[DLL] | CertEnroll.dll |