Funzione IoWMIOpenBlock (wdm.h)

Articolo
08/08/2023

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