IObjectId::GetAlgorithmName メソッド (certenroll.h)

GetAlgorithmName メソッドは、アルゴリズム オブジェクト識別子 (OID) に関連付けられている表示名を取得します。

構文

HRESULT GetAlgorithmName(
  [in]  ObjectIdGroupId        GroupId,
  [in]  ObjectIdPublicKeyFlags KeyFlags,
  [out] BSTR                   *pstrAlgorithmName
);

パラメーター

[in] GroupId

検索する OID グループを指定する ObjectIdGroupId 列挙値。 これには、次のアルゴリズム グループのいずれかを指定できます。

• XCN_CRYPT_HASH_ALG_OID_GROUP_ID
• XCN_CRYPT_ENCRYPT_ALG_OID_GROUP_ID
• XCN_CRYPT_PUBKEY_ALG_OID_GROUP_ID
• XCN_CRYPT_SIGN_ALG_OID_GROUP_ID

• XCN_CRYPT_RDN_ATTR_OID_GROUP_ID
• XCN_CRYPT_EXT_OR_ATTR_OID_GROUP_ID
• XCN_CRYPT_ENHKEY_USAGE_OID_GROUP_ID
• XCN_CRYPT_POLICY_OID_GROUP_ID
• XCN_CRYPT_TEMPLATE_OID_GROUP_ID

[in] KeyFlags

署名アルゴリズムと暗号化アルゴリズムのどちらを検索するかを指定する ObjectIdPublicKeyFlags 列挙値。 次のいずれかの値を指定できます。

• XCN_CRYPT_OID_INFO_PUBKEY_ANY
• XCN_CRYPT_OID_INFO_PUBKEY_SIGN_KEY_FLAG
• XCN_CRYPT_OID_INFO_PUBKEY_ENCRYPT_KEY_FLAG

[out] pstrAlgorithmName

名前を含む BSTR 変数へのポインター。

戻り値

関数が成功した場合、関数は S_OKを返します。

関数が失敗した場合は、エラーを示す HRESULT 値を返します。 使用できる値には、次の表に示す値が含まれますが、これらに限定されません。 一般的なエラー コードの一覧については、「 共通 HRESULT 値」を参照してください。

注釈

XCN_CRYPT_ENCRYPT_ALG_OID_GROUP_ID定数を使用すると、可変ビット長で識別できるアルゴリズムのキー サイズを考慮した GroupId パラメーター値を作成できます。 たとえば、192 ビット AES アルゴリズムから IObjectId オブジェクトを初期化するには、 strAlgorithmName パラメーターに "AES" を指定し、長さを 16 だけシフトし、シフトされたビット長と XCN_CRYPT_ENCRYPT_ALG_OID_GROUP_IDにビットごとの OR の組み合わせを実行します。

GroupId パラメーターを XCN_CRYPT_PUBKEY_ALG_OID_GROUP_ID 以外に設定する場合は、KeyFlags パラメーターにXCN_CRYPT_OID_INFO_PUBKEY_ANYを指定します。

Requirements

こちらも参照ください

IObjectId