[函式探索可用於需求一節中指定的作業系統。 後續版本可能會變更或無法使用。]
開啟函式實例的屬性存放區。 屬性存放區包含函式實例的相關中繼資料，例如其名稱、圖示、安裝日期和其他資訊。
語法
HRESULT OpenPropertyStore(
[in] DWORD dwStgAccess,
[out] IPropertyStore **ppIPropertyStore
);
參數
[in] dwStgAccess
要指派給開啟資料流程的存取模式。 針對此方法，支援下列存取模式：
STGM_READ
STGM_READWRITE
STGM_WRITE
[out] ppIPropertyStore
IPropertyStore介面指標的指標。
傳回值
可能的傳回值包括但不限於下列各項。
| 傳回碼 | 描述 |
|---|---|
|
已成功完成命令。 |
|
方法無法開啟可寫入的屬性存放區，因為呼叫端的存取權不足，或探索提供者不允許寫入其屬性存放區。 |
|
dwStgAccess的值無效。 |
|
ppIPropertyStore指向不正確記憶體。 |
|
方法無法配置執行這項作業所需的記憶體。 |
備註
每個函式實例一次只能開啟一個屬性存放區。 如果在相同的函式實例上呼叫 OpenPropertyStore 兩次，這兩個 ppIPropertyStore 指標都會指向相同的屬性存放區。 此外，存取模式 (由 dwStgAccess 參數所指定，) 是由最新的 OpenPropertyStore 呼叫所決定。 應用程式應該先呼叫 Release 來關閉屬性存放區，然後再開啟另一個存放區。
OpenPropertyStore可能會傳回已移除之裝置的屬性存放區。 在此情況下，存放區中的屬性索引鍵會是空的。 如果已刪除裝置的開發 節點 ，但與裝置函式實例相關聯的屬性存放區仍可存取，就可能發生這種情況。 這種情況很少發生。
需求
| 最低支援的用戶端 | Windows Vista [僅限傳統型應用程式] |
| 最低支援的伺服器 | Windows Server 2008 [僅限傳統型應用程式] |
| 目標平台 | Windows |
| 標頭 | functiondiscoveryapi.h |
| Dll | FunDisc.dll |