Funzione GetPropertyHandle
Restituisce un handle univoco che identifica una proprietà.
Nota
Questa API è solo per uso interno. Non è destinata all'uso dal codice dello sviluppatore.
Sintassi
HRESULT GetPropertyHandle (
[in] int vFunc,
[in] IWbemObjectAccess* ptr,
[in] LPCWSTR wszPropertyName,
[out] CIMTYPE* pType,
[out] long* pHandle
);
Parametri
vFunc
[in] Questo parametro non è usato.
ptr
[in] Puntatore a un'istanza di IWbemObjectAccess .
wszPropertyName
[in] Stringa con terminazione Null di caratteri con codifica UTF16 che contiene il nome della proprietà.
pType
[out] Puntatore a un CIMTYPE membro di enumerazione che rappresenta il tipo CIM della proprietà.
pHandle
[out] Puntatore a un numero intero che contiene l'handle di proprietà.
Valore restituito
I valori seguenti restituiti da questa funzione sono definiti nel file di intestazione WbemCli.h oppure è possibile definirli come costanti nel codice:
| Costante | Valore | Descrizione |
|---|---|---|
WBEM_E_NOT_FOUND |
0x80041002 | Il nome della proprietà specificato non è stato trovato. |
WBEM_E_INVALID_PARAMETER |
0x80041008 | Un parametro non è valido. |
WBEM_E_NOT_SUPPORTED |
0x8004100c | La proprietà richiesta è di tipo CIM_OBJECT o CIM_ARRAY. |
WBEM_S_NO_ERROR |
0 | La chiamata di funzione ha avuto esito positivo. |
Commenti
Questa funzione esegue il wrapping di una chiamata al metodo IWbemClassObject::GetPropertyHandle .
È possibile usare questo handle per identificare le proprietà quando si usano i metodi IWbemObjectAccess per leggere o scrivere valori di proprietà.
Gli handle possono essere recuperati per le proprietà di tutti i tipi di dati diversi da CIM_OBJECT e CIM_ARRAY. Gli handle restituiti funzionano in tutte le istanze di una classe.
Requisiti
Piattaforme: vedere Requisiti di sistema di .NET Framework.
Intestazione: WMINet_Utils.idl
Versioni di .NET Framework: Disponibile dalla versione 4.7.2
