IX500DistinguishedName::Encode メソッド (certenroll.h)

Encode メソッドは、識別名を含む文字列からオブジェクトを初期化します。このメソッドは Web 対応です。

構文

HRESULT Encode(
  [in] BSTR          strName,
  [in] X500NameFlags NameFlags
);

[in] strName

エンコードする文字列を含む BSTR 変数。

[in] NameFlags

エンコードされた値の形式を指定する X500NameFlags 列挙値。

メモ次のフラグが自動的に設定されます。

Certenroll.h で指定された既定値は XCN_CERT_NAME_STR_NONE。
XCN_CERT_NAME_STR_FORWARD_FLAGを指定しない場合は、XCN_CERT_NAME_STR_REVERSE_FLAGが自動的に適用されます。
XCN_CERT_NAME_STR_DISABLE_UTF8_DIR_STR_FLAGを指定しない場合は、XCN_CERT_NAME_STR_FORCE_UTF8_DIR_STR_FLAGが自動的に適用されます。
XCN_CERT_NAME_STR_ENABLE_PUNYCODE_FLAGは、指定した他のフラグに関係なく自動的に設定されます。

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

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

リターンコード/値	Description
E_OUTOFMEMORY	エンコードされた値にメモリを割り当てませんでした。
E_POINTER	strName パラメーターを NULL にすることはできません。
HRESULT_FROM_WIN32(ERROR_FILENAME_EXCED_RANGE)	strName パラメーターの文字数は 64 * 1024 を超えることはできません。

このメソッドは、CryptoAPI CertStrToName 関数を内部的に呼び出します。 Name プロパティを呼び出して、null で終わる文字列として名前を取得します。 EncodedName プロパティを呼び出して、エンコードされた名前を含む文字列を取得します。