IFileSaveDialog::SetProperties-Methode (shobjidl_core.h)

Bietet einen Eigenschaftenspeicher, der die Standardwerte definiert, die für das zu speichernde Element verwendet werden sollen.

Syntax

HRESULT SetProperties(
  [in] IPropertyStore *pStore
);

Parameter

[in] pStore

Typ: IPropertyStore*

Zeiger auf die Schnittstelle, die den Eigenschaftenspeicher darstellt, der die zugeordneten Metadaten enthält.

Rückgabewert

Typ: HRESULT

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

Hinweise

Diese Methode kann jederzeit aufgerufen werden, bevor das Dialogfeld geöffnet wird oder während der Dialog angezeigt wird. Wenn ein Element über inhärente Eigenschaften verfügt, sollte diese Methode mit diesen Eigenschaften aufgerufen werden, bevor das Dialogfeld angezeigt wird.

Wenn Sie Speichern unter verwenden, sollte die Anwendung die Eigenschaften des Elements angeben, das im Dialogfeld Speichern gespeichert wird. Diese Eigenschaften sollten durch Aufrufen von GetPropertyStore mit dem GPS_HANDLERPROPERTIESONLY-Flag aus dem ursprünglichen Element erneut entfernt werden.

Um die Eigenschaften des gespeicherten Elements abzurufen (die möglicherweise vom Benutzer geändert wurden), nachdem das Dialogfeld geschlossen wurde, rufen Sie IFileSaveDialog::GetProperties auf.

Verwenden Sie IFileSaveDialog::SetCollectedProperties, um die Eigenschaftensammlung zu aktivieren und anzugeben, welche Eigenschaften im Dialogfeld Speichern angezeigt werden sollen.

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

Weitere Informationen

IFileSaveDialog

IFileSaveDialog::GetProperties

IFileSaveDialog::SetCollectedProperties