Enables a calling application to associate a GUID with a dialog's persisted state.
HRESULT SetClientGuid( REFGUID guid );
The GUID to associate with this dialog state.
If this method succeeds, it returns S_OK. Otherwise, it returns an HRESULT error code.
A dialog's state can include factors such as the last visited folder and the position and size of the dialog.
Typically, this state is persisted based on the name of the executable file. By specifying a GUID, an application can have different persisted states for different versions of the dialog within the same application (for example, an import dialog and an open dialog).
IFileDialog::SetClientGuid should be called immediately after creation of the dialog object.
|Minimum supported client||Windows Vista [desktop apps only]|
|Minimum supported server||Windows Server 2008 [desktop apps only]|
|Header||shobjidl_core.h (include Shobjidl.h)|