AssocGetPerceivedType 함수(shlwapi.h)

확장자를 기반으로 파일의 인식된 형식을 검색합니다.

구문

LWSTDAPI AssocGetPerceivedType(
  [in]            PCWSTR        pszExt,
  [out]           PERCEIVED     *ptype,
  [out]           PERCEIVEDFLAG *pflag,
  [out, optional] PWSTR         *ppszType
);

매개 변수

[in] pszExt

형식: PCWSTR

파일의 확장자를 포함하는 버퍼에 대한 포인터입니다. 여기에는 선행 기간(예: ".txt")이 포함되어야 합니다.

[out] ptype

형식: 인식됨*

인식된 형식을 나타내는 PERCEIVED 값에 대한 포인터입니다.

[out] pflag

형식: PERCEIVEDFLAG*

인식된 형식 정보의 원본을 나타내는 값에 대한 포인터입니다. 다음 값 중 하나 이상입니다.

PERCEIVEDFLAG_UNDEFINED(0x0000)

인식된 형식을 찾을 수 없습니다(PERCEIVED_TYPE_UNSPECIFIED).

PERCEIVEDFLAG_SOFTCODED(0x0001)

인식된 형식은 레지스트리의 연결을 통해 결정되었습니다.

PERCEIVEDFLAG_HARDCODED(0x0002)

인식된 형식은 기본적으로 Windows에 알려져 있습니다.

PERCEIVEDFLAG_NATIVESUPPORT(0x0004)

인식된 형식은 Windows와 함께 제공되는 코덱을 통해 결정되었습니다.

PERCEIVEDFLAG_GDIPLUS(0x0010)

인식된 형식은 GDI+ 라이브러리에서 지원됩니다.

PERCEIVEDFLAG_WMSDK(0x0020)

인식된 형식은 Windows Media SDK에서 지원됩니다.

PERCEIVEDFLAG_ZIPFOLDER(0x0040)

인식된 형식은 Windows 압축 폴더에서 지원됩니다.

[out, optional] ppszType

형식: PWSTR*

함수가 성공 코드를 반환하는 경우 "text" 또는 "video"instance 인식된 형식 문자열을 수신하는 버퍼에 대한 포인터의 주소가 포함됩니다. 이 값은 NULL일 수 있습니다.

반환 값

형식: HRESULT

이 함수가 성공하면 S_OK 반환합니다. 그러지 않으면 HRESULT 오류 코드를 반환합니다.

설명

이 함수는 먼저 Windows에 알려진 하드 코딩된 확장 집합과 확장을 비교합니다. 해당 검색이 일치 항목을 표시하지 못하면 HKEY_CLASSES_ROOT 아래에 등록된 연결이 확장과 일치하는 키를 검색하고 PerceivedType 값을 포함합니다. 해당 값이 발견되면 확장 집합이 일치 항목을 다시 검색합니다. 일치하는 항목이 다시 없으면 인식된 형식이 PERCEIVED_TYPE_CUSTOM 것으로 결정됩니다. 확장과 일치하는 키 또는 PerceivedType 값을 찾을 수 없는 경우 인식된 형식은 PERCEIVED_TYPE_UNSPECIFIED 보고됩니다.

요구 사항

요구 사항	값
지원되는 최소 클라이언트	WINDOWS XP SP2 [데스크톱 앱만 해당]
지원되는 최소 서버	Windows Server 2003 [데스크톱 앱만 해당]
대상 플랫폼	Windows
헤더	shlwapi.h
라이브러리	Shlwapi.lib
DLL	Shlwapi.dll(버전 6.0 이상)