IFileDialog::SetClientGuid 메서드(shobjidl_core.h)

호출 애플리케이션이 GUID를 대화 상자의 지속형 상태와 연결할 수 있도록 합니다.

구문

HRESULT SetClientGuid(
  [in] REFGUID guid
);

매개 변수

[in] guid

형식: REFGUID

이 대화 상자 상태와 연결할 GUID입니다.

반환 값

형식: HRESULT

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

설명

대화 상자의 상태에는 마지막으로 방문한 폴더, 대화 상자의 위치 및 크기와 같은 요소가 포함될 수 있습니다.

일반적으로 해당 상태는 실행 파일의 이름을 기반으로 지속됩니다. GUID를 지정하면 동일한 애플리케이션 내에서 대화 상자의 버전마다 지속 상태가 달라질 수 있습니다(예: 가져오기 대화 상자와 열기 대화 상자).

대화 상자 개체를 만든 직후 IFileDialog::SetClientGuid를 호출해야 합니다.

요구 사항

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