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

Weitere Informationen

IActiveDesktop