IFunctionDiscoveryProvider：：InstancePropertyStoreValidateAccess 方法 (functiondiscoveryprovider.h)

[函式探索可用於需求一節中指定的作業系統。 它可能會在後續版本中改變或無法使用。]

確認提供者是否支援要求的存取權。 在函式實例上呼叫 OpenPropertyStore 時會呼叫它，以確認提供者支援 dwStgAccess 參數傳遞的存取模式。

只有在提供者的 Initialize 方法傳回 -1 的 pdwStgAccessCapabilities 參數值時，才會呼叫這個方法。

語法

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 方法時，您可以在任何提供的函式實例上針對任何提供的 dwStgAccess 模式值傳回STG_E_ACCESSDENIED。

規格需求

需求	值
最低支援的用戶端	Windows Vista [僅限傳統型應用程式]
最低支援的伺服器	Windows Server 2008 [僅限傳統型應用程式]
目標平台	Windows
標頭	functiondiscoveryprovider.h

另請參閱

IFunctionDiscoveryProvider