WritePropertyValue, fonction
Écrit un nombre spécifié d’octets dans une propriété identifiée par un descripteur de propriété.
Notes
Cette API est destinée à un usage interne uniquement. Elle n’est pas destinée à être utilisée dans le code du développeur.
Syntaxe
HRESULT WritePropertyValue (
[in] int vFunc,
[in] IWbemObjectAccess* ptr,
[in] long lHandle,
[in] long lNumBytes,
[in] byte* aData
);
Paramètres
vFunc
[in] Ce paramètre est inutilisé.
ptr
[in] Pointeur désignant une instance d’IWbemObjectAccess.
lHandle
[in] Entier contenant la poignée qui identifie cette propriété. La poignée peut être récupérée en appelant la fonction GetPropertyHandle.
lNumBytes
[in] Nombre d’octets écrits dans la propriété. Pour plus d’informations, consultez la section Remarques.
pHandle [out] Pointeur désignant le tableau d’octets qui contient les données.
Valeur retournée
Les valeurs suivantes renvoyées par cette fonction sont définies dans le fichier d’en-tête WbemCli.h, ou vous pouvez les définir comme constantes dans votre code :
| Constant | Valeur | Description |
|---|---|---|
WBEM_E_INVALID_PARAMETER |
0x80041008 | Un paramètre n'est pas valide. |
WBEM_E_TYPE_MISMATCH |
0x80041005 | Une incompatibilité de type est survenue. |
WBEM_S_NO_ERROR |
0 | L’appel de fonction a abouti. |
Notes
Cette fonction encapsule un appel à la méthode IWbemClassObject::WritePropertyValue.
Utilisez cette fonction pour définir la chaîne et toutes les autres données autres que DWORD ou QWORD.
Pour les valeurs de propriété qui ne sont pas des chaînes, lNumBytes doit être la taille de données correcte du type de propriété spécifié. Pour les valeurs de propriété de chaîne, lNumBytes doit être la longueur de la chaîne spécifiée en octets, et la chaîne elle-même doit être d’une longueur égale en octets et être suivie d’un caractère de terminaison nul.
Spécifications
Plateformes : Consultez Configuration requise.
En-tête : WMINet_Utils.idl
Versions de .NET Framework : disponibles depuis la version 4.7.2
