Funzione IoWMISetSingleItem (wdm.h)

Articolo
02/27/2024

La routine IoWMISetSingleItem imposta una singola proprietà nell'istanza del blocco di dati che corrisponde alla classe WMI e al nome dell'istanza specificati.

Sintassi

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

Parametri

[in] DataBlockObject

Puntatore a un oggetto blocco di dati WMI. Il chiamante apre l'oggetto blocco dati per la classe WMI con la routine IoWMIOpenBlock . L'oggetto deve essere aperto con il diritto di accesso WMIGUID_SET.

[in] InstanceName

Specifica il nome dell'istanza del blocco di dati. Questo valore corrisponde al valore della proprietà InstanceName per il blocco.

[in] DataItemId

Specifica l'ID elemento di dati per la proprietà da impostare. Il valore di questo parametro corrisponde al valore dichiarato nel qualificatore WmiDataId per la proprietà .

[in] Version

Riservato per utilizzi futuri. I chiamanti devono impostare questo parametro su zero.

[in] ValueBufferSize

Specifica le dimensioni, in byte, del buffer passato nel parametro ValueBuffer .

[in] ValueBuffer

Puntatore al buffer contenente il nuovo valore per la proprietà specificata dal parametro DataItemId .

Valore restituito

La routine restituisce un codice NTSTATUS. I valori restituiti possibili includono:

Codice restituito	Descrizione
STATUS_SUCCESS	Operazione completata. Il valore della proprietà all'interno dell'istanza del blocco di dati WMI viene aggiornato al contenuto del buffer a cui punta il parametro ValueBuffer .
STATUS_WMI_GUID_NOT_FOUND	Nessun driver implementa la classe WMI.
STATUS_WMI_INSTANCE_NOT_FOUND	Nessun driver implementa un'istanza del blocco di dati WMI con la proprietà InstanceName uguale al valore specificato nel parametro InstanceName .
STATUS_WMI_ITEMID_NOT_FOUND	La classe WMI non contiene una proprietà con ID elemento di dati uguale al valore di DataItemId.
STATUS_WMI_READ_ONLY	L'ID elemento di dati nel blocco di dati è di sola lettura.
STATUS_WMI_SET_FAILURE	Il driver che implementa l'istanza del blocco di dati WMI non è in grado di aggiornare la proprietà specificata da DataItemId.

Commenti

IoWMISetSingleItem determina quali driver possono supportare la classe WMI e il nome dell'istanza specificati. Invia una richiesta di IRP_MN_CHANGE_SINGLE_ITEM a ogni driver. Il driver che esporta l'istanza del blocco di dati con la proprietà InstanceName corrispondente aggiorna la proprietà specificata nell'istanza del blocco di dati.

I driver possono anche usare IoWMISetSingleInstance per aggiornare contemporaneamente ogni proprietà dell'istanza della classe WMI.

Requisiti

Requisito	Valore
Client minimo supportato	Disponibile in Windows XP e versioni successive del sistema operativo Windows.
Piattaforma di destinazione	Universale
Intestazione	wdm.h (include Wdm.h, Ntddk.h, Ntifs.h)
Libreria	NtosKrnl.lib
DLL	NtosKrnl.exe
IRQL	<= APC_LEVEL

Vedi anche

IRP_MN_CHANGE_SINGLE_ITEM

IoWMIOpenBlock

IoWMIQuerySingleInstance

IoWMISetSingleInstance

Condividi tramite