IFileDialog::SetClientGuid-Methode (shobjidl_core.h)

Ermöglicht es einer aufrufenden Anwendung, eine GUID dem persistenten Zustand eines Dialogfelds zuzuordnen.

Syntax

HRESULT SetClientGuid(
  [in] REFGUID guid
);

Parameter

[in] guid

Typ: REFGUID

Die GUID, die diesem Dialogzustand zugeordnet werden soll.

Rückgabewert

Typ: HRESULT

Wenn diese Methode erfolgreich ist, wird S_OK zurückgegeben. Andernfalls wird ein Fehlercode HRESULT zurückgegeben.

Hinweise

Der Zustand eines Dialogfelds kann Faktoren wie den zuletzt besuchten Ordner und die Position und Größe des Dialogfelds beinhalten.

Dieser Zustand wird in der Regel basierend auf dem Namen der ausführbaren Datei beibehalten. Durch Angeben einer GUID kann eine Anwendung unterschiedliche beibehaltene Zustände für verschiedene Versionen des Dialogfelds innerhalb derselben Anwendung aufweisen (z. B. ein Dialogfeld zum Importieren und ein Dialogfeld zum Öffnen).

IFileDialog::SetClientGuid sollte unmittelbar nach der Erstellung des Dialogobjekts aufgerufen werden.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows Vista [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2008 [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	shobjidl_core.h (shobjidl.h einschließen)