IoWMISetSingleItem, fonction (wdm.h)

Article
02/07/2025

La routine IoWMISetSingleItem définit une propriété unique dans l’instance de bloc de données qui correspond à la classe WMI spécifiée et au nom de l’instance.

Syntaxe

NTSTATUS IoWMISetSingleItem(
  [in] PVOID           DataBlockObject,
  [in] PUNICODE_STRING InstanceName,
  [in] ULONG           DataItemId,
  [in] ULONG           Version,
  [in] ULONG           ValueBufferSize,
  [in] PVOID           ValueBuffer
);

Paramètres

[in] DataBlockObject

Pointeur vers un objet de bloc de données WMI. L’appelant ouvre l’objet de bloc de données pour la classe WMI avec la routine IoWMIOpenBlock. L’objet doit être ouvert avec le droit d’accès WMIGUID_SET.

[in] InstanceName

Spécifie le nom de l’instance du bloc de données. Cette valeur correspond à la valeur de la propriété InstanceName pour le bloc.

[in] DataItemId

Spécifie l’ID d’élément de données de la propriété à définir. La valeur de ce paramètre correspond à la valeur déclarée dans la WmiDataId qualificateur pour la propriété.

[in] Version

Réservé pour une utilisation ultérieure. Les appelants doivent définir ce paramètre sur zéro.

[in] ValueBufferSize

Spécifie la taille, en octets, de la mémoire tampon passée dans le paramètre ValueBuffer.

[in] ValueBuffer

Pointeur vers la mémoire tampon qui contient la nouvelle valeur de la propriété spécifiée par le paramètre DataItemId.

Valeur de retour

La routine retourne un code NTSTATUS. Les valeurs de retour possibles sont les suivantes :

Retourner le code	Description
STATUS_SUCCESS	L’opération a réussi. La valeur de la propriété dans l’instance de bloc de données WMI est mise à jour vers le contenu de la mémoire tampon pointée par le paramètre ValueBuffer.
STATUS_WMI_GUID_NOT_FOUND	Aucun pilote n’implémente la classe WMI.
STATUS_WMI_INSTANCE_NOT_FOUND	Aucun pilote n’implémente une instance du bloc de données WMI avec propriété InstanceName égale à la valeur spécifiée dans le paramètre InstanceName.
STATUS_WMI_ITEMID_NOT_FOUND	La classe WMI ne contient pas de propriété dont l’ID d’élément de données est égal à la valeur de DataItemId.
STATUS_WMI_READ_ONLY	L’ID d’élément de données dans le bloc de données est en lecture seule.
STATUS_WMI_SET_FAILURE	Le pilote qui implémente l’instance de bloc de données WMI ne peut pas mettre à jour la propriété spécifiée par DataItemId.

Remarques

IoWMISetSingleItem détermine quels pilotes peuvent prendre en charge la classe WMI et le nom d’instance spécifiés. Il émet une demande de IRP_MN_CHANGE_SINGLE_ITEM à chacun de ces pilotes. Le pilote qui exporte l’instance de bloc de données avec InstanceName propriété met à jour la propriété spécifiée dans l’instance de bloc de données.

Les pilotes peuvent également utiliser IoWMISetSingleInstance pour mettre à jour simultanément chaque propriété de l’instance de classe WMI.

Exigences

Exigence	Valeur
client minimum pris en charge	Disponible dans Windows XP et versions ultérieures du système d’exploitation Windows.
plateforme cible	Universel
d’en-tête	wdm.h (include Wdm.h, Ntddk.h, Ntifs.h)
bibliothèque	NtosKrnl.lib
DLL	NtosKrnl.exe
IRQL	<= APC_LEVEL

Voir aussi

IRP_MN_CHANGE_SINGLE_ITEM

IoWMIOpenBlock

IoWMIQuerySingleInstance

IoWMISetSingleInstance

Partager via