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 di dati WMI. Il chiamante apre l'oggetto blocco di 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 possibili valori restituiti includono:
| Codice restituito | Descrizione |
|---|---|
|
Operazione riuscita. La routine riempie la struttura UNICODE_STRING a cui punta il parametro InstanceName con il nome dell'istanza. |
|
Il driver non implementa istanze della classe WMI specificata da DataBlockObject. |
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 |