GetPropertyQualifierSet 函式
擷取特定屬性的限定詞集合。
注意
此 API 僅供內部使用。 不是要讓您在開發人員程式碼中使用。
語法
HRESULT GetPropertyQualifierSet (
[in] int vFunc,
[in] IWbemClassObject* ptr,
[in] LPCWSTR wszProperty,
[out] IWbemQualifierSet **ppQualSet
);
參數
vFunc
[in] 此參數未使用。
ptr
[in] IWbemClassObject 執行個體的指標。
wszMethod
[in] 屬性名稱。 wszProperty 必須指向有效的 LPCWSTR。
ppQualSet
[out] 接收介面指標，以允許存取屬性的限定詞。 ppQualSet 不可以是 null。 如果發生錯誤，則不會傳回新的物件，而且會將指標設定為指向 null。
傳回值
此函式傳回的下列值定義於 WbemCli.h 標頭檔中，或者，您可以將其定義為程式碼中的常數：
| 常數 | 值 | 描述 |
|---|---|---|
WBEM_E_FAILED |
0x80041001 | 發生一般失敗。 |
WBEM_E_NOT_FOUND |
0x80041002 | 指定的方法不存在。 |
WBEM_E_OUT_OF_MEMORY |
0x80041006 | 可用的記憶體不足，無法完成作業。 |
WBEM_E_INVALID_PARAMETER |
0x80041008 | 參數為 null。 |
WBEM_E_SYSTEM_PROPERTY |
0x80041030 | 函式會嘗試取得系統屬性的限定詞。 |
WBEM_S_NO_ERROR |
0 | 函式呼叫成功。 |
備註
此函式會包裝向 IWbemClassObject::GetPropertyQualifierSet 方法發出的呼叫。
只有在目前的物件是 CIM 類別定義時，才支援呼叫此函式。 指向 CIM 執行個體的 IWbemClassObject 指標無法使用方法操作。
每個方法可能會有自己的限定詞，因此 IWbemQualifierSet 指標可讓呼叫端新增、編輯或刪除這些限定詞。
因為系統屬性沒有限定詞，所以如果您嘗試取得系統屬性的 IWbemQualifierSet 指標，函式會傳回 WBEM_E_SYSTEM_PROPERTY。
規格需求
平台：請參閱系統需求。
標頭：WMINet_Utils.idl
.NET Framework版本：自 4.7.2 起提供
