Метод IFunctionDiscovery::GetInstance (functiondiscoveryapi.h)

[Функция обнаружения доступна для использования в операционных системах, указанных в разделе Требования. Он может быть изменен или недоступен в последующих версиях.]

Возвращает указанный экземпляр функции на основе идентификатора.

Синтаксис

HRESULT GetInstance(
  [in]  const WCHAR       *pszFunctionInstanceIdentity,
  [out] IFunctionInstance **ppIFunctionInstance
);

Параметры

[in] pszFunctionInstanceIdentity

Идентификатор экземпляра функции (см. GetID).

[out] ppIFunctionInstance

Указатель на указатель интерфейса IFunctionInstance , используемый для возврата интерфейса.

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

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

Возвращаемый код или значение	Описание
S_OK	Метод завершился успешно.
E_INVALIDARG	Недопустимое значение параметра pszFunctionInstanceIdentity .
E_OUTOFMEMORY	Метод не может выделить память, необходимую для выполнения этой операции.
HRESULT_FROM_WIN32(ERROR_OBJECT_NOT_FOUND) 0x800710d8	Экземпляр функции, представленный указанным идентификатором, не существует на этом компьютере.
E_PENDING	Вызов был выполнен для поставщика, который возвращает результаты асинхронно.

Комментарии

Некоторые поставщики обнаружения функций возвращают результаты запроса с помощью интерфейса IFunctionDiscoveryNotification . GetInstance не находит экземпляры функций, возвращаемые таким образом, и при E_PENDING произойдет сбой. Клиентам рекомендуется использовать метод CreateInstanceQuery интерфейса IFunctionDiscovery для поиска экземпляров функций для таких поставщиков.

Требования

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

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

IFunctionDiscovery