Поделиться через

Метод 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 .

Комментарии

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

Требования

Требование Значение
Минимальная версия клиента Windows 2000 Professional, Windows XP [только классические приложения]
Минимальная версия сервера Windows 2000 Server [только классические приложения]
Целевая платформа Windows
Header shlobj_core.h
DLL Shell32.dll (версия 4.71 или более поздняя)

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

IActiveDesktop