Funzione WritePropertyValue
Scrive un numero specificato di byte in una proprietà identificata da un handle di proprietà.
Nota
Questa API è solo per uso interno. Non è destinata all'uso dal codice dello sviluppatore.
Sintassi
HRESULT WritePropertyValue (
[in] int vFunc,
[in] IWbemObjectAccess* ptr,
[in] long lHandle,
[in] long lNumBytes,
[in] byte* aData
);
Parametri
vFunc
[in] Questo parametro non è usato.
ptr
[in] Puntatore a un'istanza di IWbemObjectAccess .
lHandle
[in] Intero contenente l'handle che identifica questa proprietà. L'handle può essere recuperato chiamando la funzione GetPropertyHandle .
lNumBytes
[in] Numero di byte scritti nella proprietà . Per altre informazioni, vedere la sezione Osservazioni .
pHandle [out] Puntatore alla matrice di byte che contiene i dati.
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_INVALID_PARAMETER |
0x80041008 | Un parametro non è valido. |
WBEM_E_TYPE_MISMATCH |
0x80041005 | Si è verificata un'incongruenza di tipo. |
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::WritePropertyValue .
Usare questa funzione per impostare la stringa e tutti gli altri dati nonDWORD o nonQWORD .
Per i valori delle proprietà nonstring, lNumBytes deve essere la dimensione dei dati corretta del tipo di proprietà specificato. Per i valori delle proprietà stringa, lNumBytes deve essere la lunghezza della stringa specificata in byte e la stringa stessa deve avere una lunghezza pari in byte e deve essere seguita con un carattere di terminazione Null.
Requisiti
Piattaforme: vedere Requisiti di sistema di .NET Framework.
Intestazione: WMINet_Utils.idl
Versioni di .NET Framework: Disponibile dalla versione 4.7.2
