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 값과 다른 값을 반환합니다.
| 반환 코드 | 설명 |
|---|---|
|
오류 코드 설명이 성공적으로 검색되었습니다. |
|
로캘에 사용할 수 있는 문자열이 없습니다. |
설명
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 |