Microsoft MVP성태의 닷넷 이야기
글쓴 사람
정성태 (techsharer at outlook.com)
홈페이지
첨부 파일
 

COM 프로그래밍에서 HRESULT 타입의 S_FALSE는 실패일까요? 성공일까요?

결론부터 말하면 HRESULT 타입의 S_FALSE 반환값은 성공에 해당합니다. 확인을 위해 다음과 같이 간단하게 코드를 작성할 수 있습니다.

#include "stdafx.h"

int _tmain(int argc, _TCHAR* argv[])
{
    HRESULT hr = S_FALSE;

    printf("SUCCEEDED == %d\n", SUCCEEDED(hr)); // 출력값: 1
    return 0;
}

SUCCEEDED 매크로의 정의를 보면 확실히 알 수 있는데요.

#define SUCCEEDED(hr) (((HRESULT)(hr)) >= 0)

0 이상의 값이면 True라는 의미인데,

#define S_OK 0x0
#define S_FALSE 0x1

과 같은 식으로 값이 할당되어 있기 때문에 S_OK와 S_FALSE는 모두 SUCCEEDED 매크로에 대해 True 값을 반환하게 됩니다. 실제로 이에 대해 마이크로소프트 측의 공식 문서에서도 언급하고 있습니다.

Error Handling in COM
; https://docs.microsoft.com/en-us/windows/win32/learnwin32/error-handling-in-com

그럼 의문을 가질 수 있는 부분이 있는데, 그렇다면 실패한 경우의 일반적인 값으로 S_FALSE 대신 어떤 것을 반환해야 할 것인가? 하는 문제가 남습니다. 그럴 때는 E_FAIL 같은 값을 사용하면 됩니다.

#define E_FAIL 0x80004005

0x8...로 시작하기 때문에 최상위 비트가 1이고 이 때문에 HRESULT 타입에서는 음수값으로 표현됩니다.

처음에는 저도 이런 정책에 대해 이해를 할 수 없었는데 "Error Handling in COM" 문서의 다음 글을 읽고 그나마 수긍하게 되었습니다.

For example, the CoInitializeEx function returns S_FALSE if you call it a second time from the same thread.




사실, 이게 문제가 되는 경우가 있었는데요.

ICorProfilerInfo *ptr = ...;

IUnknown *pOut = nullptr;
HRESULT hr = ptr->GetModuleMetaData(moduleId, ..., &pOut);
if (FAILED(hr) == TRUE)
{
    return;
}

// 이하, GetModuleMetaData 호출이 성공했으므로 pOut 인터페이스 사용하는 코드 작성

저렇게 작성한 코드에서 간혹 가다가 프로세스 비정상 종료 현상이 발생한 것입니다. (현실적으로, 그 많은 코드 중에 잘 실행되지도 않던 저 부분에 문제가 있다는 것을 알게 되기까지는 제법 시간이 걸렸습니다. ^^;)

알고 보니, 가끔씩 S_FALSE 값이 반환되는 경우가 있었고 그럴 때 pOut은 nullptr 였는데 이 상태에서 사용을 하다 보니 비정상 종료가 발생한 것입니다. 그런데 왜? S_FALSE 값을 반환했느냐가 궁금해졌는데, 문서를 찾아보니 해답이 나왔습니다.

ICorProfilerInfo::GetModuleMetaData Method
; https://docs.microsoft.com/en-us/dotnet/framework/unmanaged-api/profiling/icorprofilerinfo-getmodulemetadata-method

Some modules (such as resource modules) have no metadata. In those cases, GetModuleMetaData will return an HRESULT value of S_FALSE, and a null in *ppOut.


즉, 전달된 .NET 모듈 식별자(moduleId)가 메타데이터를 가지고 있지 않은 경우에는 S_FALSE를 반환한 것입니다. 일면 이해가 됩니다. 닷넷의 경우 사용자가 만든 대부분의 모듈은 메타데이터를 가지고 있지만, 간혹 마이크로소프트가 만든 것은 다중 모듈로 분리된 어셈블리를 형성하고 있기 때문에 이런 경우가 발생합니다. (결국 그런 상황이 겹쳐서 프로세스 비정상 종료가 일정한 규칙을 갖지 않고 발생하게 된 원인이 되어 더욱 문제 해결에 애를 먹었습니다.)

휴~~~ 암튼, 이래서 문서를 꼭 봐야 한다는!




[이 글에 대해서 여러분들과 의견을 공유하고 싶습니다. 틀리거나 미흡한 부분 또는 의문 사항이 있으시면 언제든 댓글 남겨주십시오.]







[최초 등록일: ]
[최종 수정일: 7/17/2021]

Creative Commons License
이 저작물은 크리에이티브 커먼즈 코리아 저작자표시-비영리-변경금지 2.0 대한민국 라이센스에 따라 이용하실 수 있습니다.
by SeongTae Jeong, mailto:techsharer at outlook.com

비밀번호

댓글 작성자
 



2015-01-27 01시42분
[hhyyaa] hr == S_OK 가 아니라... SUCCEEDED(hr)를 써야할 이유가 있었군요. ㅡㅡ; S_FALSE도 성공이었다니...
[guest]
2016-04-23 07시23분
[테엘] Error Handling in COM 문서에서 Community Additions(kittoinc)이 더 황당함. 위에서 그렇게 resource에 관한 rule들을 언급했는데도 저런 딴지를 걸다니... 저런 식으로 return하면 동일한 resource 해제문이 점점 늘어난다는 생각은 안하나봐요!
[guest]

... [151]  152  153  154  155  156  157  158  159  160  161  162  163  164  165  ...
NoWriterDateCnt.TitleFile(s)
1277정성태5/8/201231256오류 유형: 152. cmd.exe - The system cannot write to the specified device. [2]
1276정성태4/28/201223114Phone: 5. 모든 Marketplace에 윈폰 앱을 등록하는 방법 [1]
1275정성태4/28/201226987개발 환경 구성: 150. 프로세스 실행으로 잠긴 파일이지만, 이름은 변경가능하다는 사실! 아셨나요? [7]
1274정성태4/17/201221502Phone: 4. "Holiday Calendar" 윈폰 응용 프로그램 등록
1273정성태4/6/201224704Phone: 3. 윈도우 폰을 위한 Holiyday Calendar 앱 개발파일 다운로드1
1272정성태4/5/201226282오류 유형: 151. ASP.NET - EcbGetUnicodeServerVariables 코드에서 System.AccessViolationException 예외 발생
1271정성태4/3/201228955Math: 6. 동전을 여러 더미로 나누는 경우의 수 세기 [1]
1270정성태3/29/201222921오류 유형: 150. Visual Studio 2010 원격 디버깅 오류 - Kerberos authentication failed
1269정성태3/27/201236737오류 유형: 149. ODP.NET 오류 - The provider is not compatible with the version of Oracle client
1268정성태3/27/201233216오류 유형: 148. WCF svc 호출 시 HTTP Error 404.17 - Not Found [1]
1267정성태3/16/201231185.NET Framework: 314. C++의 inline asm 사용을 .NET으로 포팅하는 방법 [1]파일 다운로드1
1266정성태3/14/201234409개발 환경 구성: 149. RAID 1 구성 시 하드 디스크 장애 발생 해결에 대한 경험담
1265정성태3/13/201224704VC++: 61. 아이태니엄(IA64: Itanium) 에서 겪은 C++ 포인터 연산 문제 [2]
1264정성태3/10/201244115.NET Framework: 313. WELL512 난수 발생 알고리즘 - C# [5]파일 다운로드1
1263정성태3/9/201222915개발 환경 구성: 148. tinyget 사용법
1262정성태3/8/201243783개발 환경 구성: 147. .keystore 파일에 저장된 개인키 추출 방법과 인증기관으로부터 온 공개키를 합친 pfx 파일 만드는 방법 [1]
1261정성태3/7/201224482Phone: 2. 개발자용 윈도우 폰 7 기기 등록하는 방법
1260정성태3/6/201224342Phone: 1. 윈도폰 7 개발자 (회사) 등록하는 방법 [3]
1259정성태3/4/201235836Windows: 57. 새로 추가된 네트워크 커널 디버깅 및 PowerShell 3.0 [1]
1258정성태3/3/201237467개발 환경 구성: 146. SQL Server 2012에 포함된 LocalDB 기능 소개 [3]파일 다운로드1
1257정성태3/3/201225654.NET Framework: 312. Native 스레드와 Managed 스레드 개체의 상태 관계 [1]파일 다운로드1
1256정성태3/3/201229210Math: 5. Euler's totient function - C#파일 다운로드1
1255정성태3/3/201231585Math: 4. 소수 판정 및 소인수 분해 소스 코드 - C# [1]파일 다운로드1
1254정성태3/1/201226553Windows: 56. Windows 8 Consumer Preview를 사용해 보고... [1]
1253정성태3/1/201228026VS.NET IDE: 71. Visual Studio 11 Ultimate 베타 설치 [3]
1252정성태3/1/201225366Windows: 55. 윈도우 8 베타 설치 과정 [1]
... [151]  152  153  154  155  156  157  158  159  160  161  162  163  164  165  ...