Share via


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 プロパティを呼び出して、エンコードされた名前を含む文字列を取得します。

要件

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

こちらもご覧ください

IX500DistinguishedName