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

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

Проверяет, поддерживает ли поставщик запрошенный доступ. Он вызывается при вызове OpenPropertyStore в экземпляре функции, чтобы убедиться, что поставщик поддерживает режим доступа, передаваемый параметром dwStgAccess .

Этот метод вызывается только в том случае, если метод Initialize поставщика возвращает значение параметра pdwStgAccessCapabilities , равное -1.

Синтаксис

HRESULT InstancePropertyStoreValidateAccess(
  [in] IFunctionInstance *pIFunctionInstance,
  [in] INT_PTR           iProviderInstanceContext,
  [in] const DWORD       dwStgAccess
);

Параметры

[in] pIFunctionInstance

Указатель на интерфейс IFunctionInstance .

[in] iProviderInstanceContext

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

[in] dwStgAccess

Режим доступа для проверки. Для этого метода поддерживаются следующие режимы:

STGM_READ

STGM_READWRITE

STGM_WRITE

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

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

Код возврата	Описание
S_OK	Метод завершился успешно.
E_NOTIMPL	Поставщик не реализует хранилище свойств экземпляра.
STG_E_ACCESSDENIED	Методу не удалось открыть хранилище свойств, доступное для записи, так как вызывающий объект имеет недостаточный доступ, поставщик обнаружения не разрешает доступ на запись в хранилище свойств или другое хранилище свойств уже открыто для этого экземпляра функции.
E_INVALIDARG	Недопустимое значение dwStgAccess .
E_OUTOFMEMORY	Метод не может выделить память, необходимую для выполнения этой операции.

Комментарии

Точное значение возвращаемого значения STG_E_ACCESSDENIED зависит от реализации. При реализации метода InstancePropertyStoreValidateAccess можно вернуть STG_E_ACCESSDENIED для любого предоставленного значения режима dwStgAccess для любого предоставленного экземпляра функции.

Требования

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

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

IFunctionDiscoveryProvider