Funzione IoWMIQuerySingleInstance (wdm.h)
La routine IoWMIQuerySingleInstance restituisce l'istanza specificata di un blocco di dati WMI.
Sintassi
NTSTATUS IoWMIQuerySingleInstance(
[in] PVOID DataBlockObject,
[in] PUNICODE_STRING InstanceName,
[in, out] PULONG InOutBufferSize,
[out, optional] PVOID OutBuffer
);
Parametri
[in] DataBlockObject
Puntatore a un oggetto blocco di dati WMI. Il chiamante apre l'oggetto blocco di dati per la classe WMI con la routine IoWMIOpenBlock. L'oggetto deve essere aperto con il diritto di accesso WMIGUID_QUERY.
[in] InstanceName
Specifica il nome dell'istanza del blocco di dati. Questo valore corrisponde al valore della proprietà InstanceName per il blocco.
[in, out] InOutBufferSize
Puntatore a una posizione di memoria che specifica le dimensioni del buffer passato nel parametro OutBuffer. Se la routine ha esito positivo, aggiorna il percorso di memoria per specificare il numero di byte effettivamente archiviati in OutBuffer. Se la routine ha esito negativo con codice di stato di STATUS_BUFFER_TOO_SMALL, restituisce il numero di byte necessari per restituire i dati.
[out, optional] OutBuffer
Puntatore al buffer in cui la routine restituisce i dati WMI. La routine restituisce una struttura di WNODE_SINGLE_INSTANCE di dimensioni variabili. OutBuffer deve puntare a un buffer allocato da un pool non di paging.
Valore restituito
La routine restituisce un codice NTSTATUS. I possibili valori restituiti includono:
| Codice restituito | Descrizione |
|---|---|
|
Operazione riuscita. La routine restituisce i dati WMI nel buffer a cui punta il parametro OutBuffer. La routine restituisce anche le dimensioni, in byte, dei dati restituiti nella posizione di memoria a cui punta il parametro InOutBufferSize. |
|
Nessun driver implementa la classe WMI specificata. |
|
Nessun driver implementa un'istanza della classe WMI con proprietà InstanceName uguale al valore specificato nel parametro InstanceName. |
|
Il buffer passato dal chiamante nel parametro outbuffer è troppo piccolo. La routine restituisce le dimensioni del buffer necessarie nella posizione di memoria a cui punta il parametro InOutBufferSize. |
Osservazioni
IoWMIQuerySingleInstance determina quali driver possono supportare la classe WMI specificata con il nome dell'istanza specificato e invia una richiesta di IRP_MN_QUERY_SINGLE_INSTANCE a ogni driver. Il driver che esporta l'istanza del blocco di dati con proprietà InstanceName corrispondente restituisce i dati appropriati.
Per eseguire query su più classi WMI e nomi di istanza, usare la routine IoWMIQuerySingleInstanceMultiple. I driver possono usare la routine IoWMISetSingleInstance per aggiornare l'istanza della classe.
Fabbisogno
| 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 |