IFileSaveDialog::ApplyProperties-Methode (shobjidl_core.h)

Artikel
03/02/2024

Wendet einen Satz von Eigenschaften mithilfe der Kopier-Engine der Shell auf ein Element an.

Syntax

HRESULT ApplyProperties(
  [in] IShellItem                 *psi,
  [in] IPropertyStore             *pStore,
  [in] HWND                       hwnd,
  [in] IFileOperationProgressSink *pSink
);

Parameter

[in] psi

Typ: IShellItem*

Zeiger auf das IShellItem , das die zu speichernde Datei darstellt. Dies ist in der Regel das element, das von GetResult abgerufen wird.

[in] pStore

Typ: IPropertyStore*

Zeiger auf den IPropertyStore , der die Eigenschaftswerte darstellt, die auf die Datei angewendet werden sollen. Dies kann der von IFileSaveDialog::GetProperties zurückgegebene Eigenschaftenspeicher sein.

[in] hwnd

Typ: HWND

Das Handle des Anwendungsfensters.

[in] pSink

Typ: IFileOperationProgressSink*

Zeiger auf einen optionalen IFileOperationProgressSink , den die aufrufende Anwendung verwenden kann, wenn sie über den Fortschritt der Eigenschaftenstempelung benachrichtigt werden möchte. Dieser Wert kann NULL sein.

Rückgabewert

Typ: HRESULT

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

Hinweise

Diese Methode sollte verwendet werden, wenn die Anwendung die Eigenschaftensammlung aktiviert hat (IFileSaveDialog::SetCollectedProperties), die Eigenschaften selbst jedoch nicht in der gespeicherten Datei gespeichert.

Hinweis Die durch das in psi angegebene Element dargestellte Datei muss vor dem Aufruf von IFileSaveDialog::ApplyProperties im physischen Speicher vorhanden sein. Daher muss sie zu einem bestimmten Zeitpunkt gespeichert worden sein.

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

Freigeben über