PSLookupPropertyHandlerCLSID 함수(propsys.h)

컴퓨터별 등록된 파일 속성 처리기의 CLSID(클래스 식별자)를 가져옵니다.

구문

PSSTDAPI PSLookupPropertyHandlerCLSID(
  [in]  PCWSTR pszFilePath,
  [out] CLSID  *pclsid
);

매개 변수

[in] pszFilePath

형식: PCWSTR

속성 처리기 CLSID가 요청된 파일의 절대 경로를 포함하는 null로 끝나는 유니코드 버퍼에 대한 포인터입니다.

[out] pclsid

형식: CLSID*

이 함수가 반환되면 요청된 속성 처리기 CLSID가 포함됩니다.

반환 값

형식: PSSTDAPI

성공하면 S_OK 반환하고, 그렇지 않으면 오류 값을 반환합니다.

설명

처리기를 등록하는 방법에 대한 자세한 내용은 속성 처리기 초기화를 참조하세요.

이 함수는 HKEY_LOCAL_MACHINE 등록된 처리기만 반환합니다.

대부분의 호출 애플리케이션은 이 메서드를 호출하거나 CoCreateInstance 를 사용하여 속성 처리기를 직접 만들 필요가 없습니다. 대신 호출 애플리케이션은 IShellItem2::GetPropertyStore 를 사용하여 Windows Vista에서 셸 항목에 대한 속성 저장소를 만들어야 합니다. IShellItem2::GetPropertyStore 는 셸 항목에 사용할 수 있는 속성의 가장 큰 집합과 반환할 속성을 정확하게 사용자 지정하기 위한 가장 많은 옵션을 제공합니다.

지정된 파일에 대해 속성 처리기가 등록되지 않은 경우 이 함수는 오류 코드를 반환합니다. 이 경우 IShellItem2::GetPropertyStore에서 반환된 속성 저장소에서 특정 파일 시스템 속성을 읽을 수 있습니다.

코드에서 속성 처리기를 만들어야 하고 Windows Vista와 Windows XP에서 모두 실행해야 하는 애플리케이션은 PSGetItemPropertyHandler 를 호출하여 Microsoft WDS(Windows Desktop Search) 재배포 가능 패키지를 통해 셸 항목에 대한 속성 저장소를 만들 수 있습니다.

예제

더 큰 프로그램의 일부로 포함할 다음 예제에서는 PSLookupPropertyHandlerCLSID를 사용하는 방법을 보여 줍니다.

CLSID clsid;

HRESULT hr = PSLookupPropertyHandlerCLSID(L"C:\\windows\\system32\\shell32.dll", &clsid);

if (SUCCEEDED(hr))
{
    // clsid contains the CLSID of the property handler used for 
    // C:\windows\system32\shell32.dll.
}

요구 사항

지원되는 최소 클라이언트	WINDOWS XP SP2, Windows Vista [데스크톱 앱만 해당]
지원되는 최소 서버	WINDOWS Server 2003 SP1 [데스크톱 앱만 해당]
대상 플랫폼	Windows
헤더	propsys.h
라이브러리	Propsys.lib
DLL	Propsys.dll(버전 6.0 이상)
재배포 가능 파일	WDS(Windows 데스크톱 검색) 3.0

추가 정보

IShellItem2::GetPropertyStore

PSGetItemPropertyHandler