IBackgroundCopyManager::GetErrorDescription 메서드(bits.h)

지정된 오류 코드에 대한 설명을 검색합니다.

구문

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

매개 변수

[in] hResult

BITS 메서드에 대한 이전 호출의 오류 코드입니다.

[in] LanguageId

설명을 생성하는 데 사용할 언어 식별자를 식별합니다. 언어 식별자를 만들려면 MAKELANGID 매크로를 사용합니다. 예를 들어 미국 영어를 지정하려면 다음 코드 샘플을 사용합니다.

MAKELANGID(LANG_ENGLISH, SUBLANG_ENGLISH_US)

시스템의 기본 사용자 언어 식별자를 검색하려면 다음 호출을 사용합니다.

LANGIDFROMLCID(GetThreadLocale())

[out] pErrorDescription

오류에 대한 설명이 포함된 Null로 끝나는 문자열입니다. 완료되면 CoTaskMemFree 함수를 호출하여 ppErrorDescription을 해제합니다.

반환 값

이 메서드는 다음 HRESULT 값과 다른 값을 반환합니다.

반환 코드	설명
S_OK	오류 코드 설명이 성공적으로 검색되었습니다.
HRESULT_FROM_WIN32(ERROR_RESOURCE_LANG_NOT_FOUND)	로캘에 사용할 수 있는 문자열이 없습니다.

설명

HTTP 오류에 대한 설명은 지역화됩니다.

Windows XP/2000: HTTP 오류에 대한 설명은 지역화되지 않습니다.

예제

다음 예제에서는 오류 코드와 연결된 설명을 검색하는 방법을 보여줍니다. 예제의 g_XferManager 변수는 IBackgroundCopyManager 인터페이스 포인터입니다. IBackgroundCopyManager 인터페이스 포인터를 만드는 방법에 대한 자세한 내용은 BITS 서비스에 연결을 참조하세요.

HRESULT hr = 0;
IBackgroundCopyJob* pJob = NULL;
WCHAR* pszDescription = NULL;

//Call fails because the third parameter is NULL.
hr = g_XferManager->CreateJob(L"DummyJob", BG_JOB_TYPE_DOWNLOAD, NULL, &pJob);
if (FAILED(hr))
{
  hr = g_XferManager->GetErrorDescription(hr, LANGIDFROMLCID(GetThreadLocale()), &pszDescription);
  if (SUCCEEDED(hr))
  {
    //Do something with pszDescription.
    CoTaskMemFree(pszDescription);
  }
}

요구 사항

요구 사항	값
지원되는 최소 클라이언트	Windows XP
지원되는 최소 서버	Windows Server 2003
대상 플랫폼	Windows
헤더	bits.h
라이브러리	Bits.lib
DLL	QmgrPrxy.dll

추가 정보

오류 처리

IBackgroundCopyError

IBackgroundCopyJob::GetError