SHGetViewStatePropertyBag 함수(shlwapi.h)

아티클
08/26/2023

[SHGetViewStatePropertyBag 은 요구 사항 섹션에 지정된 운영 체제에서 사용할 수 있습니다. 이후 버전에서는 변경되거나 제공되지 않을 수 있습니다.]

폴더에 대한 뷰 상태 정보를 저장하고 이후에 검색할 수 있는 속성 모음을 검색합니다. 사용자의 설정은 다음에 사용자가 폴더를 방문할 때 유지됩니다.

구문

LWSTDAPI SHGetViewStatePropertyBag(
  [in, optional] PCIDLIST_ABSOLUTE pidl,
  [in, optional] PCWSTR            pszBagName,
                 DWORD             dwFlags,
  [in]           REFIID            riid,
  [out]          void              **ppv
);

매개 변수

[in, optional] pidl

형식: PCIDLIST_ABSOLUTE

속성을 요청하는 폴더의 PIDL입니다. SHGVSPB_ALLFOLDERS 플래그가 전달된 경우 이 매개 변수는 NULL 이어야 합니다.

[in, optional] pszBagName

형식: PCWSTR

요청된 속성 모음의 이름을 포함하는 문자열에 대한 포인터입니다.

dwFlags

형식:DWORD

다음 플래그의 조합을 지정하는 값입니다.

다음 플래그 집합의 값 하나가 필요합니다.

SHGVSPB_PERUSER

지정된 pidl에 대한 사용자별 속성을 반환합니다.

SHGVSPB_ALLUSERS

지정된 pidl에 대한 모든 사용자 속성을 반환합니다.

다음 플래그 집합의 값 하나가 필요합니다.

SHGVSPB_PERFOLDER

pidl 매개 변수로 지정된 폴더의 속성 모음을 반환합니다.

SHGVSPB_ALLFOLDERS

모든 폴더에 적용되는 속성 모음을 반환합니다.

SHGVSPB_INHERIT

속성 모음이 없는 하위 폴더에 대한 기본값을 제공하는 데 사용되는 속성 모음을 반환합니다.

다음 플래그는 선택 사항입니다.

SHGVSPB_ROAM

속성 모음이 로밍되도록 허용합니다. 로밍 사용자 프로필을 참조하세요. 이 플래그는 SHGVSPB_ALLFOLDERS 결합할 수 없습니다.

SHGVSPB_NOAUTODEFAULTS

지정된 폴더에 대한 속성 모음을 찾을 수 없는 경우 적절한 기본값에 대한 검색을 표시하지 않습니다. 기본적으로 SHGVSPB_INHERIT 지정되지 않고 지정된 폴더에 대한 속성 모음을 찾을 수 없는 경우 시스템은 기본값을 제공할 수 있는 다른 위치에서 동일하게 명명된 속성 모음을 검색합니다. 예를 들어 시스템은 폴더의 상위 항목에서 검색하여 SHGVSPB_INHERIT 속성 모음을 제공하는지 확인합니다. 시스템 검색이 사용자 기본값 및 전역 기본값에 있는 다른 위치입니다.

다음 플래그 집합은 위에 나열된 일부 플래그를 결합하는 값으로 구성되며 간결성과 편의를 위해 사용됩니다.

SHGVSPB_FOLDER

SHGVSPB_PERUSER 및 SHGVSPB_PERFOLDER 결합합니다.

SHGVSPB_FOLDERNODEFAULTS

SHGVSPB_PERUSER, SHGVSPB_PERFOLDER 및 SHGVSPB_NOAUTODEFAULTS 결합합니다.

SHGVSPB_USERDEFAULTS

SHGVSPB_PERUSER 및 SHGVSPB_ALLFOLDERS 결합합니다.

SHGVSPB_GLOBALDEFAULTS

SHGVSPB_ALLUSERS 및 SHGVSPB_ALLFOLDERS 결합합니다.

Windows Server 2008, Windows Vista, Windows Server 2003 및 Windows XP: 이 플래그의 이름은 SHGVSPB_GLOBALDEAFAULTS.

[in] riid

형식: REFIID

ppv를 통해 검색할 인터페이스의 IID에 대한 참조입니다.

[out] ppv

형식: void**

이 메서드가 성공적으로 반환되면 는 riid에서 요청된 인터페이스 포인터를 포함합니다.

반환 값

형식: HRESULT

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

설명

시스템에서 제한된 수의 보기 상태만 유지하므로 중요한 정보는 뷰 상태 속성 모음에 저장해서는 안 됩니다. 폴더를 오랫동안 방문하지 않으면 보기 상태가 결국 삭제됩니다.

Objbase.h에 정의된 IID_PPV_ARGS 매크로를 사용하여 riid 및 ppv 매개 변수를 패키지하는 것이 좋습니다. 이 매크로는 ppv의 값이 가리키는 인터페이스를 기반으로 올바른 IID를 제공하므로 riid 에서 코딩 오류가 발생하여 예기치 않은 결과가 발생할 수 있습니다.

요구 사항

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

다음을 통해 공유