共用方式為


(wbemcli.h) IWbemObjectAccess 介面

IWbemObjectAccess 介面可讓您存取 物件的方法和屬性。 IWbemObjectAccess 對像是重新整理更新之實例的容器。 透過 IWbemObjectAccess 介面,您可以使用屬性句柄來取得和設定屬性,而不是物件屬性名稱。

注意 在任何情況下,用戶端應用程式或提供者都不會實作此介面。 WMI 所提供的實作是唯一支援的實作。 呼叫 IWbemClassObject::QueryInterface 即可擷取介面的指標。
 

繼承

IWbemObjectAccess 介面繼承自 IUnknown 介面。 IWbemObjectAccess 也有下列類型的成員:

方法

IWbemObjectAccess 介面具有這些方法。

 
IWbemObjectAccess::GetPropertyHandle

GetPropertyHandle 方法會傳回可識別屬性的唯一句柄。 使用 IWbemObjectAccess 方法來讀取或寫入屬性值時,您可以使用這個控制代碼來識別屬性。
IWbemObjectAccess::GetPropertyInfoByHandle

GetPropertyInfoByHandle 方法會傳回與屬性句柄相關聯的屬性名稱和數據類型。
IWbemObjectAccess::Lock

Lock 方法可防止其他線程更新 IWbemObjectAccess 物件,直到解除鎖定為止。
IWbemObjectAccess::ReadDWORD

ReadDWORD 方法會使用屬性句柄讀取 32 位的屬性數據。
IWbemObjectAccess::ReadPropertyValue

ReadPropertyValue 方法會傳回與屬性句柄相關聯之屬性的指定位元組數目。
IWbemObjectAccess::ReadQWORD

ReadQWORD 方法會讀取屬性句柄所識別的 64 位屬性數據。
IWbemObjectAccess::Unlock

Unlock 方法可讓其他線程更新 IWbemObjectAccess 物件的屬性值。
IWbemObjectAccess::WriteDWORD

WriteDWORD 方法會將 32 位的數據寫入屬性句柄所識別的屬性。
IWbemObjectAccess::WritePropertyValue

WritePropertyValue 方法會將指定的位元元組數目寫入屬性句柄所識別的屬性。 使用此方法可設定字串和其他所有非 DWORD 或非 QWORD 數據。
IWbemObjectAccess::WriteQWORD

WriteQWORD 方法會使用屬性句柄,將數據 64 位寫入屬性。

備註

讀取和寫入數據的 IWbemObjectAccess 方法會執行非常少的數據驗證。 因為 IWbemObjectAccess 方法可以直接存取屬性,所以您可以比使用 IWbemClassObject::GetIWbemClassObject::P ut 等標準物件存取技術來取得和設定屬性。

注意 為了最大化其速度, IWbemObjectAccess 完全未核取。 用戶的責任是確保所有句柄都正確,且寫入緩衝區的大小正確。 讀取和寫入作業不是內部安全線程。 您應該呼叫 IWbemObjectAccess::LockIWbemObjectAccess::Unlock 方法,以防止 IWbemObjectAccess 物件在多個線程上並行存取。
 
類別的所有實例的屬性句柄都相同。 因此,只需要擷取一次句柄。

規格需求

需求
最低支援的用戶端 Windows Vista
最低支援的伺服器 Windows Server 2008
目標平台 Windows
標頭 wbemcli.h (包含 Wbemidl.h)

另請參閱

存取 C++ 中的效能數據

存取 WMI 預安裝效能類別

適用於 WMI 的 COM API

IWbemRefresher