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

Weitere Informationen

IActiveDesktop