IActiveDesktop::AddUrl-Methode (shlobj_core.h)

Artikel
08/26/2023

Fügt das der angegebenen URL zugeordnete Desktopelement hinzu.

Syntax

HRESULT AddUrl(
  [in, optional] HWND        hwnd,
  [in]           PCWSTR      pszSource,
  [in]           LPCOMPONENT pcomp,
                 DWORD       dwFlags
);

Parameter

[in, optional] hwnd

Typ: HWND

Ein Handle für das übergeordnete Fenster für die Benutzeroberfläche.

[in] pszSource

Typ: PCWSTR

Ein Zeiger auf eine Zeichenfolge, die die URL des Desktopelements enthält.

[in] pcomp

Typ: LPCOMPONENT

Ein Zeiger auf die COMPONENT-Struktur , die die Details des hinzuzufügenden Desktopelements enthält.

dwFlags

Art: DWORD

Ein ganzzahliger Wert ohne Vorzeichen, der diese Methode steuert. Kann auf ADDURL_SILENT festgelegt werden, um ein Desktopelement hinzuzufügen, ohne Benutzeroberflächen anzuzeigen.

Rückgabewert

Typ: HRESULT

Gibt einen der folgenden Werte zurück.

Rückgabecode	Beschreibung
E_FAIL	Fehler beim Hinzufügen des Desktopelements oder eines instance des Desktopelements, das bereits auf dem aktiven Desktop vorhanden ist.
E_INVAILDARG	Mindestens ein 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 aktiven Desktop vorhanden. Andernfalls wurde das Desktopelement erfolgreich hinzugefügt.

Hinweise

Standardmäßig zeigt diese Methode eine Benutzeroberfläche an und fügt das Desktopelement dann dem Aktiven Desktop hinzu. Wie IActiveDesktop::AddDesktopItem muss die Clientanwendung IActiveDesktop::ApplyChanges aufrufen, damit die Änderungen in der Registrierung gespeichert werden.

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