IX500DistinguishedName::D ecode メソッド (certenroll.h)

Decode メソッドは、Unicode でエンコードされた識別名からオブジェクトを初期化します。

構文

HRESULT Decode(
  [in] BSTR          strEncodedName,
  [in] EncodingType  Encoding,
  [in] X500NameFlags NameFlags
);

[in] strEncodedName

エンコードされた名前を含む BSTR 変数。

[in] Encoding

入力文字列に適用される Unicode エンコードの種類を指定する EncodingType 列挙値。既定値は XCN_CRYPT_STRING_BASE64です。

[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	strEncodedName パラメーターを NULL にすることはできません。
HRESULT_FROM_WIN32(ERROR_FILE_NOT_FOUND)	名前をデコードできませんでした。

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