Share via

IMMDevice：：OpenPropertyStore 方法 (mmdeviceapi.h)

  • 發行項

OpenPropertyStore方法會擷取裝置屬性存放區的介面。

語法

HRESULT OpenPropertyStore(
  [in]  DWORD          stgmAccess,
  [out] IPropertyStore **ppProperties
);

參數

[in] stgmAccess

儲存體存取模式。 此參數會指定是否要在讀取模式、寫入模式或讀取/寫入模式中開啟屬性存放區。 將此參數設定為下列其中一個 STGM 常數：

STGM_READ

STGM_WRITE

STGM_READWRITE

方法允許以系統管理員身分執行的用戶端開啟存放區，以進行唯讀、唯讀或讀取/寫入存取。 未以系統管理員身分執行的用戶端僅限於唯讀存取。 如需 STGM 常數的詳細資訊，請參閱 Windows SDK 檔。

[out] ppProperties

指標變數的指標，方法會寫入裝置屬性存放區 之 IPropertyStore 介面的位址。 透過這個方法，呼叫端會取得介面的計數參考。 呼叫端負責藉由呼叫介面的 Release 方法，在不再需要介面時釋出介面。 如果 OpenPropertyStore 呼叫失敗， *ppProperties 為 Null。 如需 IPropertyStore的詳細資訊，請參閱 Windows SDK 檔。

傳回值

如果方法成功，它會傳回 S_OK。 如果失敗，可能的傳回碼包括，但不限於下表所示的值。

傳回碼 描述
E_INVALIDARG
 參數 stgmAccess 不是有效的存取模式。
E_POINTER
 參數 ppProperties 為 Null。
E_OUTOFMEMORY
 記憶體不足。

備註

一般而言，裝置屬性存放區中的屬性對於不會執行系統管理、系統或服務功能的用戶端而言是唯讀的。

如需呼叫 OpenPropertyStore 方法的程式碼範例，請參閱下列主題：

需求

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

另請參閱

IMMDevice 介面