IActiveDesktop::ModifyDesktopItem-Methode (shlobj_core.h)
Ändert das Desktopelement.
Syntax
HRESULT ModifyDesktopItem(
[in, out] LPCCOMPONENT pcomp,
DWORD dwFlags
);
Parameter
[in, out] pcomp
Typ: LPCCOMPONENT
Die Adresse der COMPONENT-Struktur , die die Änderungen enthält. Das Desktopelement, das dem wszSource-Member der Struktur zugeordnet ist, wird geändert.
dwFlags
Art: DWORD
Ein ganzzahliger Wert ohne Vorzeichen, der die für die Änderung verwendeten Flags enthält. Dies kann einer der folgenden Werte sein.
COMP_ELEM_ALL
COMP_ELEM_CHECKED
COMP_ELEM_CURITEMSTATE
COMP_ELEM_FRIENDLYNAME
COMP_ELEM_NOSCROLL
COMP_ELEM_ORIGINAL_CSI
COMP_ELEM_POS_LEFT
COMP_ELEM_POS_TOP
COMP_ELEM_POS_ZINDEX
COMP_ELEM_RESTORED_CSI
COMP_ELEM_SIZE_HEIGHT
COMP_ELEM_SIZE_WIDTH
COMP_ELEM_SOURCE
COMP_ELEM_TYPE
Rückgabewert
Typ: HRESULT
Wenn diese Methode erfolgreich ist, wird S_OK zurückgegeben. Andernfalls wird ein Fehlercode HRESULT zurückgegeben.
Hinweise
Die Clientanwendung muss IActiveDesktop::ApplyChanges separat aufrufen, um die Registrierung zu aktualisieren. Um beispielsweise den Anzeigenamen zu ändern, rufen Sie zuerst diese Funktion mit COMP_ELEM_FRIENDLYNAME oder COMP_ELEM_ALL im dwFlags-Member von COMPONENT auf. Rufen Sie dann IActiveDesktop::ApplyChanges auf.
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) | Windows 2000 Professional, Windows XP [nur Desktop-Apps] |
| Unterstützte Mindestversion (Server) | Windows 2000 Server [nur Desktop-Apps] |
| Zielplattform | Windows |
| Kopfzeile | shlobj_core.h |
| DLL | Shlobj_core.h (Version 4.71 oder höher) |