IFileOperation::ApplyPropertiesToItem-Methode (shobjidl_core.h)

  • Artikel

Deklariert ein einzelnes Element, dessen Eigenschaftswerte festgelegt werden sollen.

Syntax

HRESULT ApplyPropertiesToItem(
  [in] IShellItem *psiItem
);

Parameter

[in] psiItem

Typ: IShellItem*

Zeiger auf das Element, um die neuen Eigenschaftswerte zu empfangen.

Rückgabewert

Typ: HRESULT

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

Hinweise

Diese Methode wendet die Eigenschaften nicht auf das Element an, sondern deklariert lediglich das Element. Um Eigenschaftswerte für ein Element festzulegen, müssen Sie mindestens die hier beschriebene Reihenfolge von Aufrufen ausführen:

  1. Rufen Sie IFileOperation::SetProperties auf, um die festzulegenden eigenschaften und ihre neuen Werte zu deklarieren.
  2. Rufen Sie IFileOperation::ApplyPropertiesToItem auf, um das Element zu deklarieren, dessen Eigenschaften festgelegt werden sollen.
  3. Rufen Sie IFileOperation::P erformOperations auf , um die Eigenschaften auf das Element anzuwenden.

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)

Weitere Informationen

IFileOperation

IFileOperation::ApplyPropertiesToItems