SHSetDefaultProperties-Funktion (shobjidl.h)

  • Artikel

Wendet den Standardsatz von Eigenschaften auf ein Shellelement an.

Syntax

SHSTDAPI SHSetDefaultProperties(
  [in, optional] HWND                       hwnd,
  [in]           IShellItem                 *psi,
                 DWORD                      dwFileOpFlags,
  [in, optional] IFileOperationProgressSink *pfops
);

Parameter

[in, optional] hwnd

Typ: HWND

Ein Handle für das übergeordnete Fenster des Elements, das Fehlermeldungen empfängt. Dieser Wert kann NULL sein.

[in] psi

Typ: IShellItem*

Ein Zeiger auf das IShellItem-Objekt , das das Element darstellt.

dwFileOpFlags

Art: DWORD

Flags, die den Vorgang anpassen. Flagwerte finden Sie unter IFileOperation::SetOperationFlags .

[in, optional] pfops

Typ: IFileOperationProgressSink*

Ein Zeiger auf ein IFileOperationProgressSink-Objekt , das verwendet wird, um den Fortschritt des Vorgangs zu verfolgen. Weitere Informationen finden Sie unter IFileOperation::Advise . Dieser Wert kann NULL sein.

Rückgabewert

Typ: HRESULT

Wenn diese Funktion erfolgreich ist, gibt sie S_OK zurück. Andernfalls wird ein Fehlercode HRESULT zurückgegeben.

Hinweise

Die Liste der Eigenschaften zum Festlegen eines Standardwerts stammt aus dem Registrierungseintrag SetDefaultsFor unter der ProgID für die Dateizuordnung des Elements. Die Liste ist durch "prop:" präfixiert und enthält die kanonischen Namen der Eigenschaften zum Festlegen des Standardwerts, z. B. "prop:System.Author;System.Document.DateCreated". Die möglichen Eigenschaften für diese Liste sind System.Author, System.Document.DateCreated und System.Photo.DateTaken. Wenn der Eintrag SetDefaultsFor für die ProgID nicht vorhanden ist, verwendet diese Funktion den Standardwert, der im Eintrag SetDefaultsFor von HKEY_CLASSES_ROOT\* gefunden wurde.

Anforderungen

   
Unterstützte Mindestversion (Client) Windows Vista [nur Desktop-Apps]
Unterstützte Mindestversion (Server) Windows Server 2008 [nur Desktop-Apps]
Zielplattform Windows
Kopfzeile shobjidl.h
Bibliothek Shell32.lib
DLL Shell32.dll