IFileDialog ::SetClientGuid, méthode (shobjidl_core.h)

Permet à une application appelante d’associer un GUID à l’état persistant d’une boîte de dialogue.

Syntaxe

HRESULT SetClientGuid(
  [in] REFGUID guid
);

Paramètres

[in] guid

Type : REFGUID

GUID à associer à cet état de boîte de dialogue.

Valeur retournée

Type : HRESULT

Si cette méthode réussit, elle retourne S_OK. Sinon, elle retourne un code d’erreur HRESULT.

Remarques

L’état d’un dialogue peut inclure des facteurs tels que le dernier dossier visité, ainsi que la position et la taille du dialogue.

En règle générale, cet état est conservé en fonction du nom du fichier exécutable. En spécifiant un GUID, une application peut avoir des états persistants différents pour différentes versions de la boîte de dialogue au sein de la même application (par exemple, une boîte de dialogue d’importation et une boîte de dialogue ouverte).

IFileDialog ::SetClientGuid doit être appelé immédiatement après la création de l’objet dialog.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows Vista [applications de bureau uniquement]
Serveur minimal pris en charge	Windows Server 2008 [applications de bureau uniquement]
Plateforme cible	Windows
En-tête	shobjidl_core.h (incluez Shobjidl.h)