Метод IFunctionDiscoveryProvider::Initialize (functiondiscoveryprovider.h)

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

Инициализирует объект поставщика обнаружения функций. Этот метод должен вызываться сразу после создания объекта .

Синтаксис

HRESULT Initialize(
  [in]  IFunctionDiscoveryProviderFactory *pIFunctionDiscoveryProviderFactory,
  [in]  IFunctionDiscoveryNotification    *pIFunctionDiscoveryNotification,
  [in]  LCID                              lcidUserDefault,
  [out] DWORD                             *pdwStgAccessCapabilities
);

Параметры

[in] pIFunctionDiscoveryProviderFactory

Указатель на интерфейс IFunctionDiscoveryProviderFactory . Поставщик должен использовать этот интерфейс для создания новых объектов обнаружения функций.

[in] pIFunctionDiscoveryNotification

Указатель на интерфейс IFunctionDiscoveryNotification . Поставщик должен использовать этот интерфейс для отправки уведомлений OnUpdate, OnEvent и OnError в очередь уведомлений обнаружения функций. Уведомления в очереди отправляются клиентским программам с помощью функции обнаружения.

[in] lcidUserDefault

Идентификатор языкового стандарта вызывающего объекта. Поставщик должен использовать lcidUserDefault для возврата локализованных строк для ресурса, перечисленного поставщиком.

[out] pdwStgAccessCapabilities

Задает наименее ограниченный режим доступа к хранилищам свойств, связанным с экземплярами функций, созданными этим поставщиком.

Если значение DWORD равно -1, экземплярPropertyStoreValidateAccess будет вызываться при каждом вызове OpenPropertyStore для экземпляра функции, созданного этим поставщиком. В противном случае значение, заданное этим параметром, определяет наименее ограниченный режим доступа для всех хранилищ свойств, связанных со всеми экземплярами функций, созданными этим поставщиком. Более строгий режим доступа будет применяться к отдельному хранилищу свойств, если клиент вызывает OpenPropertyStore с параметром dwStgAccess со значением, которое является более строгим, чем указанное значение pdwStgAccessCapabilities .

Для повышения эффективности по возможности укажите значение pdwStgAccessCapabilities .

Поддерживаются следующие режимы:

STGM_READ

STGM_READWRITE

STGM_WRITE

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

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

Код возврата	Описание
S_OK	Метод завершился успешно.
E_INVALIDARG	Один из параметров содержит недопустимый аргумент.

Комментарии

Если поставщик собирается создавать объекты обнаружения функций, уведомления очередей или перечислять ресурсы с локализованными строками, необходимо вызвать AddRef и кэшировать инициализированные параметры pIFunctionDiscoveryProviderFactory, pIFunctionDiscoveryNotification и lcidUserDefault для последующего использования при реализации метода Initialize .

Требования

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

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

IFunctionDiscoveryProvider