Funzione IoWMIOpenBlock (wdm.h)
La routine IoWMIOpenBlock apre l'oggetto blocco di dati WMI per la classe WMI specificata.
Sintassi
NTSTATUS IoWMIOpenBlock(
[in] LPCGUID Guid,
[in] ULONG DesiredAccess,
[out] PVOID *DataBlockObject
);
Parametri
[in] Guid
Specifica il GUID per la classe WMI.
[in] DesiredAccess
Specifica i diritti di accesso desiderati per l'oggetto blocco di dati. Il chiamante deve disporre di diritti di accesso specifici per eseguire determinate operazioni.
Di seguito è riportata una descrizione di ogni bit di accesso corretto e delle operazioni consentite:
WMIGUID_EXECUTE
L'oggetto blocco di dati può essere utilizzato per eseguire metodi di classe WMI. Questo flag deve essere impostato per utilizzare IoWMIExecuteMethod nell'oggetto blocco di dati.
WMIGUID_NOTIFICATION
L'oggetto blocco di dati può essere utilizzato per registrare i callback delle notifiche degli eventi. Questo flag deve essere impostato per l'uso di IoWMISetNotificationCallback e può essere usato solo per i blocchi eventi WMI. I chiamanti che specificano questo flag devono specificare anche il flag SYNCHRONIZE.
WMIGUID_QUERY
L'oggetto blocco di dati può essere utilizzato per eseguire query sulle proprietà della classe WMI. Questo flag deve essere impostato per utilizzare una delle routine IoWMIQueryXxx nell'oggetto blocco di dati.
WMIGUID_SET
L'oggetto blocco di dati può essere utilizzato per impostare le proprietà della classe WMI. Questo flag deve essere impostato per utilizzare una delle routine IoWMISetXxx nell'oggetto blocco di dati.
[out] DataBlockObject
Puntatore a una posizione di memoria in cui la routine restituisce un puntatore all'oggetto blocco di dati.
Valore restituito
Restituisce STATUS_SUCCESS in caso di esito positivo o il codice di errore NTSTATUS appropriato in caso di errore.
Commenti
Il chiamante usa IoWMIOpenBlock per creare un oggetto blocco dati per il GUID della classe WMI specificato. Successivamente, il chiamante può usare l'oggetto blocco di dati per leggere o scrivere proprietà della classe WMI, eseguire metodi di classe WMI e registrare i callback per gli eventi WMI.
Usare le routine IoWMIQueryXxx e IoWMISetXxx per leggere e scrivere proprietà della classe WMI. Usare IoWMIExecuteMethod per eseguire metodi di classe WMI e usare IoWMISetNotificationCallback per registrare un callback di notifica degli eventi WMI.
Usare ObDereferenceObject per chiudere l'oggetto blocco di dati dopo che non è più necessario.
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 Ntddk.h, Ntifs.h. I valori WMIGUID_XXX vengono dichiarati in Wmistr.h. Per usarle, includere Wmistr.h. |
| Libreria | NtosKrnl.lib |
| DLL | NtosKrnl.exe |
| IRQL | <= APC_LEVEL |