IActiveDesktop::GetDesktopItem-Methode (shlobj_core.h)
Ruft das angegebene Desktopelement ab.
Syntax
HRESULT GetDesktopItem(
int nComponent,
[in, out] LPCOMPONENT pcomp,
DWORD dwReserved
);
Parameter
nComponent
Typ: int
Ein ganzzahliger Wert ohne Vorzeichen, der den Index des Desktopelements enthält. Die Indexwerte beginnen bei null. Verwenden Sie IActiveDesktop::GetDesktopItemCount , um eine Anzahl der Desktopelemente abzurufen.
[in, out] pcomp
Typ: LPCOMPONENT
Die Adresse der COMPONENT-Struktur des abgerufenen Desktopelements.
dwReserved
Art: DWORD
Reserviert. Muss auf 0 festgelegt werden.
Rückgabewert
Typ: HRESULT
Wenn diese Methode erfolgreich ist, wird S_OK zurückgegeben. Andernfalls wird ein Fehlercode HRESULT zurückgegeben.
Hinweise
Die Indexwerte ändern sich, wenn Desktopelemente hinzugefügt und aus active Desktop entfernt werden. Anwendungen können nicht davon ausgehen, dass ein Indexwert immer einem bestimmten Desktopelement zugeordnet ist.
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) |