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

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

Создает запрос для конкретного экземпляра функции.

Синтаксис

HRESULT CreateInstanceQuery(
  [in]      const WCHAR                    *pszFunctionInstanceIdentity,
  [in]      IFunctionDiscoveryNotification *pIFunctionDiscoveryNotification,
  [in, out] FDQUERYCONTEXT                 *pfdqcQueryContext,
  [out]     IFunctionInstanceQuery         **ppIFunctionInstanceQuery
);

Параметры

[in] pszFunctionInstanceIdentity

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

[in] pIFunctionDiscoveryNotification

Указатель на интерфейс IFunctionDiscoveryNotification , реализованный вызывающим приложением. Если он указан, он включает процесс уведомления об изменениях обнаружения функций. Этот параметр может иметь значение NULL; однако это требуется для поставщиков сетей.

[in, out] pfdqcQueryContext

Указатель на контекст, в котором был создан запрос. Тип FDQUERYCONTEXT определяется как DWORDLONG.

[out] ppIFunctionInstanceQuery

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

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

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

Код возврата	Описание
S_OK	Метод завершился успешно.
E_INVALIDARG	ppIFunctionInstanceQuery имеет значение NULL.
E_OUTOFMEMORY	Метод не может выделить память, необходимую для выполнения этой операции.

Комментарии

Поставщики сети обнаружения функций возвращают экземпляры только через интерфейс IFunctionDiscoveryNotification .

Этот метод инициализирует только вызов запроса. Метод Execute интерфейса IFunctionInstanceQuery , возвращаемый в ppIFunctionInstanceQuery , должен вызываться для выполнения запроса и возврата любых данных.

Требования

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

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

Запросы обнаружения функций

IFunctionDiscovery