IActiveDesktop::AddUrl-Methode (shlobj_core.h)
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 |
|---|---|
|
Fehler beim Hinzufügen des Desktopelements oder eines instance des Desktopelements, das bereits auf dem aktiven Desktop vorhanden ist. |
|
Mindestens ein Parameter war ungültig. |
|
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) |