Метод IPartsList::GetPart (devicetopology.h)

Статья
02/28/2024

Метод GetPart получает часть из списка частей.

Синтаксис

HRESULT GetPart(
  [in]  UINT  nIndex,
  [out] IPart **ppPart
);

Параметры

[in] nIndex

Номер части извлекаемой части. Если список частей содержит n частей, части нумеруются от 0 до n–1. Вызовите метод IPartsList::GetCount , чтобы получить количество частей в списке.

[out] ppPart

Указатель на переменную указателя, в которую метод записывает адрес интерфейса IPart объекта part. С помощью этого метода вызывающий объект получает подсчитываемую ссылку на интерфейс IPart . Вызывающий объект отвечает за освобождение интерфейса, когда он больше не нужен, путем вызова метода Release интерфейса. Если вызов GetPart завершается сбоем, *ppPart имеет значение NULL.

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

Если метод завершается успешно, возвращает значение S_OK. В случае сбоя возможные коды возврата включают, но не ограничиваются ими, значения, показанные в следующей таблице.

Код возврата	Описание
E_INVALIDARG	Параметр nIndex выходит за пределы диапазона.
E_POINTER	Указатель ppPart имеет значение NULL.

Требования

Требование	Значение
Минимальная версия клиента	Windows Vista [только классические приложения]
Минимальная версия сервера	Windows Server 2008 [только классические приложения]
Целевая платформа	Windows
Header	devicetopology.h

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

Интерфейс IPart

Интерфейс IPartsList

IPartsList::GetCount

Share via