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

  • [アーティクル]

InitializeFromName メソッドは、CERTENROLL_OBJECTID列挙値からオブジェクトを初期化します。 このメソッドは Web 対応です。

構文

HRESULT InitializeFromName(
  [in] CERTENROLL_OBJECTID Name
);

パラメーター

[in] Name

CERTENROLL_OBJECTID列挙値。

戻り値

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

関数が失敗した場合は、エラーを示す HRESULT 値を返します。 有効な値を次の表に示しますが、これ以外にもあります。 一般的なエラー コードの一覧については、「 共通 HRESULT 値」を参照してください。

リターン コード/値 Description
CERTSRV_E_PROPERTY_EMPTY
 OID 情報が見つかりませんでした。
CRYPT_E_UNKNOWN_ALGO
 アルゴリズム名が認識されません。
HRESULT_FROM_WIN32(ERROR_ALREADY_INITIALIZED)
 オブジェクトは既に初期化されています。

注釈

すべての CERTENROLL_OBJECTID 値は、ASN.1 オブジェクト識別子に関連付けられます。 たとえば、 XCN_OID_ECDSA_SHA1 値は、1.2.840.10045.4.1 を含む文字列に関連付けられます。 これは、iso(1)member-body(2)us(840)10045 signatures(4)sha1(1) オブジェクト識別子のドット 10 進表現です。

InitializeFromName メソッドは、ASN.1 オブジェクト識別子に関連付けられている情報をレジストリで検索します。 情報が見つかった場合、メソッドは内部的に CRYPT_OID_INFO 構造体を設定し、それを オブジェクトに関連付けます。 また、 メソッドはローカル情報を使用して、可能な場合は オブジェクトの表示名を初期化します。

次のプロパティを呼び出して、初期化された IObjectId オブジェクトに関する情報を取得できます。

要件

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

こちらもご覧ください

FriendlyName

IObjectID