Funzione IoWMIHandleToInstanceName (wdm.h)
La routine IoWMIHandleToInstanceName determina il nome dell'istanza per l'istanza della classe WMI implementata dal driver specificato da un handle di file.
Sintassi
NTSTATUS IoWMIHandleToInstanceName(
[in] PVOID DataBlockObject,
[in] HANDLE FileHandle,
[out] PUNICODE_STRING InstanceName
);
Parametri
[in] DataBlockObject
Puntatore a un oggetto blocco dati WMI. Il chiamante apre l'oggetto blocco dati per la classe WMI con la routine IoWMIOpenBlock .
[in] FileHandle
Specifica un handle di file. La routine restituisce il nome dell'istanza corrispondente al driver rappresentato dall'handle di file.
[out] InstanceName
Puntatore alla struttura UNICODE_STRING utilizzata dalla routine per restituire il nome dell'istanza. Il chiamante libera il buffer restituito all'interno di UNICODE_STRING.
Valore restituito
La routine restituisce un codice NTSTATUS. I valori restituiti possibili includono:
| Codice restituito | Descrizione |
|---|---|
|
Operazione completata. La routine riempie la struttura UNICODE_STRING puntata dal parametro InstanceName con il nome dell'istanza. |
|
Il driver non implementa alcuna istanza della classe WMI specificata da DataBlockObject. |
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 |