IBackgroundCopyError::GetErrorDescription メソッド (bits.h)

エラーに関連付けられているエラーテキストを取得します。

構文

HRESULT GetErrorDescription(
  [in]  DWORD  LanguageId,
  [out] LPWSTR *pErrorDescription
);

[in] LanguageId

説明の生成に使用するロケールを識別します。言語識別子を作成するには、 MAKELANGID マクロを使用します。たとえば、米国英語を指定するには、次のコードサンプルを使用します。

MAKELANGID(LANG_ENGLISH, SUBLANG_ENGLISH_US)

システムの既定のユーザー言語識別子を取得するには、次の呼び出しを使用します。

LANGIDFROMLCID(GetThreadLocale())

[out] pErrorDescription

エラーに関連付けられたエラーテキストを含む Null で終わる文字列。完了したら、 CoTaskMemFree 関数を呼び出して ppErrorDescription を解放します。

このメソッドは、次の HRESULT 値と他の値を返します。

リターンコード	説明
S_OK	エラーの説明が正常に取得されました。
E_OUTOFMEMORY	メモリ不足のため、操作を完了できません。
E_INVALIDARG	LanguageId パラメーターを 0 にすることはできません。
HRESULT_FROM_WIN32(ERROR_RESOURCE_LANG_NOT_FOUND)	ロケールに使用できる文字列はありません。

IBackgroundCopyManager::GetErrorDescription メソッドを呼び出して、エラーコードに関連付けられているエラーテキストを取得することもできます。

HTTP エラーの説明はローカライズされています。

Windows XP/2000: HTTP エラーの説明はローカライズされません。

「エラーの処理」トピックのコード例を参照してください。