(wbemcli.h) IWbemObjectAccess 介面

發行項
03/03/2024

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：：Get 和 IWbemClassObject：:P ut 等標準物件存取技術來取得和設定屬性。

注意為了最大化其速度， IWbemObjectAccess 完全未核取。用戶的責任是確保所有句柄都正確，且寫入緩衝區的大小正確。讀取和寫入作業不是內部安全線程。您應該呼叫 IWbemObjectAccess：：Lock 和 IWbemObjectAccess：：Unlock 方法，以防止 IWbemObjectAccess 物件在多個線程上並行存取。

類別的所有實例的屬性句柄都相同。因此，只需要擷取一次句柄。