SHSetDefaultProperties-Funktion (shobjidl.h)
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 |