Метод IActiveDesktop::GetDesktopItem (shlobj_core.h)

Возвращает указанный элемент рабочего стола.

Синтаксис

HRESULT GetDesktopItem(
            int         nComponent,
  [in, out] LPCOMPONENT pcomp,
            DWORD       dwReserved
);

Параметры

nComponent

Тип: int

Длинное целочисленное значение без знака, содержащее индекс элемента рабочего стола. Значения индекса начинаются с нуля. Используйте IActiveDesktop::GetDesktopItemCount , чтобы получить количество элементов рабочего стола.

[in, out] pcomp

Тип: LPCOMPONENT

Адрес структуры COMPONENT полученного элемента рабочего стола.

dwReserved

Тип: DWORD

Зарезервировано. Необходимо задать нулевое значение.

Возвращаемое значение

Тип: HRESULT

Если этот метод завершается успешно, он возвращает S_OK. В противном случае возвращается код ошибки HRESULT .

Комментарии

Значения индекса будут изменяться по мере добавления и удаления элементов рабочего стола из активного рабочего стола. Приложения не могут предполагать, что значение индекса всегда будет связано с определенным элементом рабочего стола.

Требования

См. также раздел

IActiveDesktop