IActiveDesktop::GetDesktopItemByID-Methode (shlobj_core.h)
Ruft das Desktopelement ab, das der angegebenen Id entspricht.
Syntax
HRESULT GetDesktopItemByID(
ULONG_PTR dwID,
[in, out] LPCOMPONENT pcomp,
DWORD dwReserved
);
Parameter
dwID
Typ: ULONG_PTR
Ein ganzzahliger Wert ohne Vorzeichen, der die Identifikation des Desktopelements enthält.
[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 Id des Desktopelements wird im dwID-Member der COMPONENT-Struktur zurückgegeben, das von der IActiveDesktop::GetDesktopItem-Methode zurückgegeben wird. Diese Identifikation ist nur gültig, bis die IActiveDesktop::ApplyChanges-Methode aufgerufen wird. Anwendungen, die dasselbe Desktopelement konsistent abrufen müssen, sollten die Desktopelemente mithilfe der Methoden IActiveDesktop::GetDesktopItem und IActiveDesktop::GetDesktopItemCount auflisten.
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) |