Hinweis
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, sich anzumelden oder das Verzeichnis zu wechseln.
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, das Verzeichnis zu wechseln.
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) |