IActiveDesktop::AddDesktopItemWithUI-Methode (shlobj_core.h)

Artikel
03/06/2024

Fügt dem aktiven Desktop ein Desktopelement hinzu, nachdem Benutzeroberflächen angezeigt wurden, die das Hinzufügen des Desktopelements bestätigen, die Berechtigungen für Sicherheitszonen überprüfen und fragen, ob der Benutzer ein Abonnement erstellen möchte.

Syntax

HRESULT AddDesktopItemWithUI(
  [in, optional] HWND        hwnd,
  [in]           LPCOMPONENT pcomp,
                 DWORD       dwReserved
);

Parameter

[in, optional] hwnd

Typ: HWND

Das Handle des übergeordneten Fensters. Wenn NULL, wird das Desktopelement hinzugefügt, ohne dass eine Benutzeroberfläche angezeigt wird, in Übereinstimmung mit den entsprechenden Sicherheitszonenberechtigungen. Weitere Informationen finden Sie unter Informationen zu URL-Sicherheitszonen.

[in] pcomp

Typ: LPCOMPONENT

Adresse der COMPONENT-Struktur , die die Details des hinzuzufügenden Desktopelements enthält.

dwReserved

Art: DWORD

Unsigned long integer value that contains the flags that control how the desktop item is added. Dies kann einer der folgenden Werte sein.

DTI_ADDUI_DEFAULT

Führen Sie die Standardaktion aus. Identisch mit der Verwendung von null.

DTI_ADDUI_DISPSUBWIZARD

Aktivieren Sie den Abonnement-Assistenten, damit der Benutzer dieses Desktopelement abonnieren kann.

DTI_ADDUI_POSITIONITEM

Weisen Sie das System an, die COMPPOS-Struktur zu untersuchen, die an den cpPos-Member der COMPONENT-Struktur übergeben wird, um sicherzustellen, dass die Werte innerhalb angemessener Grenzwerte liegen. Dieser Wert wurde für Internet Explorer 5 hinzugefügt.

Rückgabewert

Typ: HRESULT

Gibt einen der folgenden Werte zurück.

Rückgabecode	Beschreibung
E_FAIL	Das Desktopelement konnte nicht hinzugefügt werden, oder ein instance des Desktopelements ist bereits auf dem Aktiven Desktop vorhanden.
E_INVAILDARG	Mindestens einer der Parameter war ungültig.
S_OK	Wenn das ADDURL_SILENT-Flag festgelegt wurde, wurde das Desktopelement entweder erfolgreich hinzugefügt oder ist bereits auf dem Active Desktop vorhanden. Andernfalls wurde das Desktopelement erfolgreich hinzugefügt.

Hinweise

Diese Methode erstellt eine zweite instance von Active Desktop, um das Desktopelement hinzuzufügen, sodass das Desktopelement nicht im aktuellen instance angezeigt wird. Die Anwendung muss die IUnknown::Release-Methode auf dieser IActiveDesktop-Schnittstelle aufrufen und dann die CoCreateInstance-Funktion verwenden, um das Active Desktop-Objekt mit der neu hinzugefügten Komponente abzurufen.

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