AssocGetDetailsOfPropKey 함수(shlobj_core.h)

네임스페이스 확장명에서 제공하는 파일 연결 정보를 사용하여 지정된 속성 키의 값을 검색합니다.

구문

SHSTDAPI AssocGetDetailsOfPropKey(
  [in]  IShellFolder      *psf,
  [in]  PCUITEMID_CHILD   pidl,
  [in]  const PROPERTYKEY *pkey,
  [out] VARIANT           *pv,
  [out] BOOL              *pfFoundPropKey
);

매개 변수

[in] psf

형식: IShellFolder*

파일 연결의 속성 키 세부 정보를 검색할 셸 폴더에 대한 포인터입니다.

[in] pidl

형식: PCUITEMID_CHILD

파일 연결이 요청되는 자식 항목의 PIDL입니다.

[in] pkey

형식: PROPERTYKEY*

검색할 속성 키에 대한 포인터입니다.

[out] pv

형식: VARIANT*

이 함수가 반환되면 지정된 속성 키의 세부 정보가 포함됩니다.

[out] pfFoundPropKey

형식: BOOL*

이 함수가 반환되면 속성 키가 있으면 TRUE 인 플래그가 포함되고, 그렇지 않으면 FALSE입니다.

반환 값

형식: HRESULT

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

설명

이 함수는 IShellFolder네임스페이스 확장의 구현자에서만 사용됩니다. 다른 호출 애플리케이션은 PROPERTYKEY에 대한 값을 얻으려면 IShellFolder2::GetDetailsEx를 사용해야 합니다. 이 함수는 IShellFolder 네임스페이스 확장의 구현자가 사용합니다.

제공된 네임스페이스 확장은 다음 세 가지 방법 중 하나로 이 API 사용을 지원해야 합니다.

1. 제공된 네임스페이스 확장에서 IShellFolder::GetUIObjectOf(..., IID_IQueryAssociations, ...)를 구현하여 항목에 대한 IQueryAssociations 인터페이스 검색을 지원하는 경우 AssocGetDetailsOfPropKey는 제공된 파일 연결 API를 사용하여 속성 키의 값을 검색합니다.
2. 제공된 네임스페이스 확장이 IShellFolder::GetAttributesOf의 항목에 대한 SFGAO_FILESYSTEM 반환하고 항목의 구문 분석 이름을 제공하는 경우 AssocGetDetailsOfPropKey는 표준 파일 시스템 연결을 사용하여 속성 키의 값을 검색합니다.
3. 제공된 네임스페이스 확장이 IShellFolder::GetAttributesOf의 항목에 대한 SFGAO_FOLDER | SFGAO_BROWSABLE 반환하는 경우 AssocGetDetailsOfPropKey는 폴더(ASSOCCLASS_FOLDER)에 대한 파일 연결을 사용하여 속성 키의 값을 검색합니다.

구현 중인 ShellFolder에 파일 연결 메커니즘을 통해 확장할 수 있는 항목이 포함된 경우 이 함수를 사용하여 지정된 파일 연결에 대해 선언된 PropertyKeys 를 검색할 수 있습니다. 예를 들어 지정된 Shell 폴더가 세부 정보 창을 구동하고 해당 창에 표시된 속성을 타사 파일 이름 확장명에서 제어하려는 경우 이 함수를 사용하여 PKEY_PropList_PreviewDetails 반환할 수 있습니다. 이 키에는 세미콜론으로 구분된 속성 목록이 있는 해당 파일 이름 확장명 레지스트리에 선언된 값이 있습니다. 레지스트리에 파일 이름 확장명 정의 속성 목록이 있습니다. 이 목록에는 다음이 포함되지만 이에 국한되지는 않습니다.

• PKEY_PropList_PreviewDetails
• PKEY_PropList_PreviewTitle
• PKEY_PropList_FullDetails
• PKEY_PropList_TileInfo
• PKEY_PropList_ExtendedTileInfo
• PKEY_PropList_InfoTip
• PKEY_PropList_QuickTip
• PKEY_PropList_FileOperationPrompt
• PKEY_PropList_ConflictPrompt
• PKEY_PropList_SetDefaultsFor
• PKEY_PropList_NonPersonal
• PKEY_NewMenuPreferredTypes
• PKEY_NewMenuAllowedTypes

요구 사항

요구 사항	값
지원되는 최소 클라이언트	Windows Vista [데스크톱 앱만 해당]
지원되는 최소 서버	Windows Server 2008 [데스크톱 앱만 해당]
대상 플랫폼	Windows
헤더	shlobj_core.h(Shlobj.h 포함)
DLL	Shell32.dll