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

Возвращает элемент рабочего стола, соответствующий заданному идентификатору.

Синтаксис

HRESULT GetDesktopItemByID(
            ULONG_PTR   dwID,
  [in, out] LPCOMPONENT pcomp,
            DWORD       dwReserved
);

Параметры

dwID

Тип: ULONG_PTR

Длинное целое число без знака, содержащее идентификатор элемента рабочего стола.

[in, out] pcomp

Тип: LPCOMPONENT

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

dwReserved

Тип: DWORD

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

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

Тип: HRESULT

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

Комментарии

Идентификация элемента рабочего стола возвращается в элементе dwID структуры COMPONENT , который возвращается методом IActiveDesktop::GetDesktopItem . Эта идентификация действительна только до вызова метода IActiveDesktop::ApplyChanges . Приложения, которые должны последовательно получать один и тот же элемент рабочего стола, должны перечислять элементы рабочего стола с помощью методов IActiveDesktop::GetDesktopItem и IActiveDesktop::GetDesktopItemCount .

Требования

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

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

IActiveDesktop