Export (0) Print
Expand All

IFileDialog::SetClientGuid method

Enables a calling application to associate a GUID with a dialog's persisted state.

Syntax


HRESULT SetClientGuid(
  [in]  REFGUID guid
);

Parameters

guid [in]

Type: REFGUID

The GUID to associate with this dialog state.

Return value

Type: HRESULT

If this method succeeds, it returns S_OK. Otherwise, it returns an HRESULT error code.

Remarks

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.

Requirements

Minimum supported client

Windows Vista [desktop apps only]

Minimum supported server

Windows Server 2008 [desktop apps only]

Header

Shobjidl.h

IDL

Shobjidl.idl

 

 

Community Additions

ADD
Show:
© 2015 Microsoft