ICertPropertyFriendlyName::Initialize メソッド (certenroll.h)

Initialize メソッドは、証明書の表示名から オブジェクトを初期化します。 このメソッドは Web 対応です。

構文

HRESULT Initialize(
  [in] BSTR strFriendlyName
);

パラメーター

[in] strFriendlyName

名前を含む BSTR 変数。 文字列の長さは 260 文字を超えることはできません。

戻り値

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

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

リターン コード/値	Description
HRESULT_FROM_WIN32(ERROR_ALREADY_INITIALIZED)	オブジェクトは既に初期化されています。
HRESULT_FROM_WIN32(ERROR_FILENAME_EXCED_RANGE)	文字列の長さが 260 文字を超えています。

注釈

通常、登録プロセスを開始する前に、ユーザー インターフェイスまたはコマンド ラインで表示名を指定して、要求ストア内のダミー証明書に名前を関連付けることができます。 この値を取得してここで使用するには、IX509Enrollment インターフェイスで CertificateFriendlyName を呼び出します。

SetValueOnCertificate メソッドを呼び出して、プロパティを証明書に関連付けます。 表示名を取得するには、 FriendlyName プロパティを呼び出します。

要件

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

こちらもご覧ください

ICertProperties

ICertProperty

ICertPropertyDescription

ICertPropertyFriendlyName