Microsoft MVP성태의 닷넷 이야기
오류 유형: 4. [OS 지원 API] SHParseDisplayName과 Windows 2000 [링크 복사], [링크+제목 복사],
조회: 17649
글쓴 사람
정성태 (techsharer at outlook.com)
홈페이지
첨부 파일
 


예전에 만들어놨던 라이브러리의 기능 추가에 대한 문의가 있어서 최근에 SHBrowseForFolder를 이용한 폴더 선택 추가 메서드를 구현해 주었습니다. 또한 그 기능에, "최초 폴더 선택" 가능한 경로를 지정할 수 있도록 해달라는 요청에 그렇게 해주었습니다.

SHBrowseForFolder의 함수 원형이 다음과 같지요.

LPITEMIDLIST SHBrowseForFolder( LPBROWSEINFO lpbi );

유일한 인자인 BROWSEINFO 구조체는 다음과 같이 정의되어 있습니다.

typedef struct _browseinfo {
    HWND hwndOwner;
    LPCITEMIDLIST pidlRoot;
    LPTSTR pszDisplayName;
    LPCTSTR lpszTitle;
    UINT ulFlags;
    BFFCALLBACK lpfn;
    LPARAM lParam;
    int iImage;
} BROWSEINFO, *PBROWSEINFO, *LPBROWSEINFO;

여기서, pidlRoot 값이 바로 폴더 선택창을 띄웠을 때 루트로 지정되는 경로의 PIDL 값입니다. PIDL은 Windows Shell 에서 Shell 개체에 대한 유일한 값을 나타내는 ID라고 보시면 편할 것 같습니다. 혹시나, 파일 경로가 ID로 될 수 있지 않느냐 하시는 분들도 계시겠지만, 파일 경로로 표현이 안되는 Shell 개체도 있을 수 있다는 것을 아셔야 합니다. 예를 들어, 탐색기의 "내 컴퓨터" 노드는 파일 시스템이 아닌 데도 탐색기에 표시되어 있습니다. 그것을 구별하기 위해서 "파일 경로"를 사용할 수는 없기 때문에, 바로 이런 때 해당 노드를 구분해 줄 수 있는 것이 PIDL입니다.

그렇다면, 위의 값에 대해 PIDL을 어떻게 줄 수 있을까요? PIDL은 직접 사용자가 구할 수는 없습니다. 만약 임의의 경로를 지정하고 싶다면, 그 경로에 대한 PIDL 값을 구해서 pidlRoot 인자에 넣어주어야 합니다.

바로 이런 때 사용되는 메서드가 SHParseDisplayName 함수입니다.
이 함수의 원형은 다음과 같습니다.

HRESULT SHParseDisplayName( LPCWSTR pszName, IBindCtx *pbc,
    LPITEMIDLIST *ppidl, SFGAOF sfgaoIn, SFGAOF *psfgaoOut
);

pszName 인자에 우리가 알고 있는 경로를 넘겨주면 ppidl 값이 [out] 파라미터 형식으로 해서 반환이 됩니다.

이렇게 해서, 구현을 마치고 해당 COM 개체를 고객에게 넘겨 주었는데, 얼마 안 가서 바로 문제 보고가 들어왔습니다. Windows 2000에서 COM 개체 등록이 안된다는 것입니다.

이런 경우, 거의 99.999%는 새로 추가한 메서드의 의존성 때문에 그런 경우일 것입니다.

가만히 살펴보면, SHParseDisplayName 함수 추가로 인해 문제가 발생했음을 알 수 있습니다. 해당 메서드는 Shell32.dll에 구현되어 있고, 그로 인해 만들어진 DLL에 대한 Depends.exe로 살펴보면 다음 화면과 같이 "SHParseDisplayName" 항목이 "빨간색 C" 모양으로 나오는 것을 볼 수 있습니다. 즉, 구현 함수가 포함 안되어져 있다는 것이지요. (물론, MSDN 도움말을 찾아보면 Minimum operating systems 요구 사항에 Windows XP라고 나와 있습니다.)

의존성 테스트

위의 함수 때문에 Windows 2000에서는 등록 자체가 거부되고 있는 것입니다.

저는 이것을 해결해야만 했으며, 결국 위의 하면에서 왼쪽의 파란색 상자에 둘러쳐진 것과 같이 delayed-load DLL로 shell32.dll을 명시를 했습니다. 왜냐하면, RegisterServer 등록 API가 실행되는 동안에는 SHParseDisplayName API 로 인해 등록을 방해받아야 할 이유가 없기 때문입니다.

그런데, 이렇게만 해놓으면 문제가 되겠지요. 틀림없이 해당 기능을 사용하는 메서드를 호출하게 되면 여지없이 프로그램은 crash 되어집니다. 따라서, 현재의 운영체제가 Windows XP 이상인지 검사하는 코드를 추가해야 합니다.

위와 같은 해결 방법 이외에도, SHParseDisplayName API 자체를 GetProcAddress로 처리하는 방법도 있을 수 있습니다.

그나저나, 그리 대단해 보이지 않는 SHParseDisplayName API가 Internet Explorer 관련 업데이트에 포함시키지 않는 이유를 이해할 수가 없군요.






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

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

비밀번호

댓글 작성자
 




... 91  92  93  94  95  96  97  98  99  [100]  101  102  103  104  105  ...
NoWriterDateCnt.TitleFile(s)
11432정성태1/11/201826394.NET Framework: 726. WPF + Direct2D + SharpDX 출력 C# 예제파일 다운로드2
11431정성태1/11/201824364.NET Framework: 725. C# - 동기 방식이면서 비동기 메서드(awaitable)처럼 구현한 사례 [9]
11430정성태1/10/201827809.NET Framework: 724. WPF + Direct2D 출력 C# 예제 [2]파일 다운로드1
11429정성태1/9/201818518개발 환경 구성: 348. ASP.NET Core 2.1 Preview 버전 적용 방법
11428정성태1/6/201821284개발 환경 구성: 347. WinForm 프로젝트를 WPF 프로젝트 유형으로 변경하는 방법파일 다운로드1
11427정성태1/5/201819316오류 유형: 445. vcpkg 빌드 오류 - Starting the CLR failed with HRESULT 80040153
11426정성태1/5/201828981오류 유형: 444. curl로 호출할 때 발생하는 오류 정리
11425정성태1/4/201819619개발 환경 구성: 346. ASP.NET Core Web Application을 IIS에서 호스팅하는 방법 (2)
11424정성태1/4/201819174개발 환경 구성: 345. ASP.NET Core 프로젝트를 명령행에서 빌드하는 방법
11423정성태1/3/201837411VC++: 123. 내가 만든 코드보다 OpenCV의 속도가 월등히 빠른 이유 [8]파일 다운로드2
11422정성태1/2/201827968.NET Framework: 723. C# - OpenCvSharp 사용 시 C/C++을 이용한 속도 향상 (for 루프 연산) [4]파일 다운로드1
11421정성태1/2/201819770오류 유형: 443. Visual Studio - nuget configuration is invalid
11420정성태12/30/201723970.NET Framework: 722. C# - Windows 10 운영체제의 데스크톱 앱에서 음성인식(SpeechRecognizer) 사용하는 방법 [3]파일 다운로드1
11419정성태12/23/201726088.NET Framework: 721. WebClient 타입의 ...Async 메서드 호출은 왜 await + 동기 호출 시 hang 현상이 발생할까요? [2]파일 다운로드1
11418정성태12/23/201735861.NET Framework: 720. 비동기 메서드 내에서 await 시 ConfigureAwait 호출 의미 [2]파일 다운로드1
11417정성태12/22/201721707.NET Framework: 719. Task를 포함하는 async 메서드의 동작 방식 [2]
11416정성태12/21/201719358.NET Framework: 718. AsyncTaskMethodBuilder.Create() 메서드 동작 방식 [2]
11415정성태12/21/201721051.NET Framework: 717. Task를 포함하지 않는 async 메서드의 동작 방식 [6]
11414정성태12/21/201728228.NET Framework: 716. async 메서드의 void 반환 타입 사용에 대하여파일 다운로드2
11413정성태12/20/201722495개발 환경 구성: 344. 윈도우 10 - TTS 및 음성 인식을 위한 환경 설정
11412정성태12/20/201725186.NET Framework: 715. C# - Windows 10 운영체제의 데스크톱 앱에서 TTS(SpeechSynthesizer) 사용하는 방법 [1]파일 다운로드1
11411정성태12/20/201723422사물인터넷: 15. 라즈베리 파이용 C++ 프로젝트에 SSL Socket 적용
11410정성태12/20/201735710.NET Framework: 714. SSL Socket 예제 - C/C++ 서버, C# 클라이언트 [1]파일 다운로드1
11409정성태12/18/201741721VC++: 122. 오픈 소스 라이브러리를 쉽게 빌드해 주는 "C++ Package Manager for Windows: vcpkg" [7]
11408정성태12/18/201721339.NET Framework: 713. C# - SharpDX + DXGI를 이용한 윈도우 화면 캡처 소스 코드 + Direct2D 출력 + OpenCV (2)파일 다운로드1
11407정성태12/18/201724224.NET Framework: 712. C# - SharpDX + DXGI를 이용한 윈도우 화면 캡처 소스 코드 + Direct2D 출력 + OpenCV [1]파일 다운로드1
... 91  92  93  94  95  96  97  98  99  [100]  101  102  103  104  105  ...