IActiveDesktop::AddDesktopItem-Methode (shlobj_core.h)

Artikel
03/04/2024

Fügt ein Desktopelement hinzu.

Syntax

HRESULT AddDesktopItem(
  [in] LPCCOMPONENT pcomp,
       DWORD        dwReserved
);

Parameter

[in] pcomp

Typ: LPCCOMPONENT

Ein Zeiger auf die COMPONENT-Struktur , der das hinzuzufügende Element angibt.

dwReserved

Art: DWORD

Reserviert. Muss auf 0 festgelegt werden.

Rückgabewert

Typ: HRESULT

Gibt einen der folgenden Werte zurück.

Rückgabecode	Beschreibung
E_FAIL	Fehler beim Hinzufügen des Desktopelements, oder ein instance des Desktopelements ist bereits auf dem Aktiven Desktop vorhanden.
E_INVAILDARG	Mindestens ein Parameter war ungültig.
S_OK	Das Desktopelement wurde erfolgreich hinzugefügt.

Hinweise

Das Desktopelement wird dem Desktop hinzugefügt, es wird jedoch nicht in der Registrierung gespeichert. Die Clientanwendung muss IActiveDesktop::ApplyChanges separat aufrufen, um die Registrierung zu aktualisieren.

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	Shell32.dll (Version 4.71 oder höher)

Weitere Informationen

IActiveDesktop

Verwenden des Active Desktop-Objekts

Freigeben über