IExplorerBrowser::SetPropertyBag 메서드(shobjidl_core.h)

속성 모음의 이름을 설정합니다.

구문

HRESULT SetPropertyBag(
  [in] LPCWSTR pszPropertyBag
);

매개 변수

[in] pszPropertyBag

형식: LPCWSTR

속성 모음의 이름을 포함하는 null로 끝나는 상수 유니코드 문자열에 대한 포인터입니다. 이 이름을 사용하여 클라이언트의 애플리케이션과 관련된 상태 정보를 저장(유지)합니다.

반환 값

형식: HRESULT

메서드가 성공하면 S_OK를 반환하고, 그러지 않으면 HRESULT 오류 코드를 반환합니다.

설명

ExplorerBrowser는 SHGetViewStatePropertyBag 함수를 호출하여 속성 모음에 저장된 속성을 검색할 수 있습니다. ExplorerBrowser는 레지스트리에 저장(유지)되는 이 속성 모음에 씁니다. 지속성은 ExplorerBrowser가 현재 보기를 삭제하거나 탐색을 시작하거나 삭제할 때 자동으로 발생합니다. 이러한 이벤트 후에는 사용자가 수정한 경우 보기 상태에 대한 정보를 씁니다.

속성이 저장되지 않은 경우 ExplorerBrowser의 기본 보기 상태가 사용됩니다. 기본 보기 상태는 사용자가 특정 위치에 대해 설정한 보기 상태이거나 위치에 대한 보기 상태가 설정되지 않은 경우(사용자가 수정하지 않음) 기본 보기 상태는 해당 위치의 파일 형식(예: 문서, 음악 및 그림)에 대한 템플릿을 기반으로 합니다. 모든 Explorer 창은 동일한 시퀀스를 사용하여 기본 보기 상태를 결정합니다.

요구 사항