IoWMISetSingleInstance, fonction (wdm.h)
La routine IoWMISetSingleInstance définit les valeurs des propriétés dans l’instance de bloc de données qui correspond à la classe WMI spécifiée et au nom de l’instance.
Syntaxe
NTSTATUS IoWMISetSingleInstance(
[in] PVOID DataBlockObject,
[in] PUNICODE_STRING InstanceName,
[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] 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 les nouvelles valeurs des propriétés dans le bloc de données.
Valeur de retour
La routine retourne un code NTSTATUS. Les valeurs de retour possibles sont les suivantes :
Retourner le code | Description |
---|---|
|
L’opération a réussi. Les valeurs des propriétés de l’instance de bloc de données WMI sont mises à jour vers le contenu de la mémoire tampon pointée par le paramètre ValueBuffer. |
|
Aucun pilote n’implémente la classe WMI. |
|
Aucun pilote n’implémente une instance de la classe WMI avec propriété InstanceName égale à la valeur spécifiée dans le paramètre InstanceName. |
|
Toutes les propriétés de la classe WMI sont en lecture seule. |
|
Le pilote qui implémente l’instance de bloc de données WMI ne peut pas mettre à jour l’instance. |
Remarques
IoWMISetSingleInstance détermine quels pilotes peuvent prendre en charge le nom de classe et d’instance WMI spécifiés et émet une demande de IRP_MN_CHANGE_SINGLE_INSTANCE à chacun de ces pilotes. Le pilote qui exporte l’instance de bloc de données avec InstanceName propriété met à jour son instance de bloc de données. Notez qu’un bloc de données peut avoir des propriétés en lecture seule et en lecture/écriture. Dans ce cas, seules les propriétés en lecture/écriture sont mises à jour et STATUS_SUCCESS est retournée.
Les pilotes peuvent également utiliser la routine IoWMISetSingleItem pour mettre à jour une propriété unique dans l’instance de classe.
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 |