Metodo IFileDialog::SetClientGuid (shobjidl_core.h)

Consente a un'applicazione chiamante di associare un GUID allo stato persistente di un dialogo.

Sintassi

HRESULT SetClientGuid(
  [in] REFGUID guid
);

Parametri

[in] guid

Tipo: REFGUID

GUID da associare a questo stato del dialogo.

Valore restituito

Tipo: HRESULT

Se questo metodo ha esito positivo, restituisce S_OK. In caso contrario, restituisce un codice di errore HRESULT .

Commenti

Lo stato di un dialogo può includere fattori come l'ultima cartella visitata e la posizione e le dimensioni del dialogo.

In genere, questo stato viene salvato in modo permanente in base al nome del file eseguibile. Specificando un GUID, un'applicazione può avere stati permanenti diversi per versioni diverse della finestra di dialogo all'interno della stessa applicazione, ad esempio una finestra di dialogo di importazione e una finestra di dialogo aperta.

IFileDialog::SetClientGuid deve essere chiamato immediatamente dopo la creazione dell'oggetto dialog.

Requisiti