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 usare IoWMIExecuteMethod nell'oggetto blocco di dati.

WMIGUID_NOTIFICATION

L'oggetto blocco di dati può essere usato per registrare i callback delle notifiche degli eventi. Questo flag deve essere impostato per usare IoWMISetNotificationCallbacke 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 usato per eseguire query sulle proprietà della classe WMI. Questo flag deve essere impostato per utilizzare una delle routine IoWMIQueryXxx sull'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.

Osservazioni

Il chiamante usa IoWMIOpenBlock per creare un oggetto blocco di 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.

Utilizzare le routine IoWMIQueryXxx e IoWMISetXxx per leggere e scrivere proprietà della classe WMI. Utilizzare IoWMIExecuteMethod per eseguire metodi di classe WMI e usare IoWMISetNotificationCallback per registrare un callback di notifica eventi WMI.

Usare ObDereferenceObject per chiudere l'oggetto blocco di dati una volta che non è più necessario.

Fabbisogno

Vedere anche

IoWMIExecuteMethod

IoWMIQueryAllData

IoWMIQueryAllDataMultiple

IoWMIQuerySingleInstance

IoWMIQuerySingleInstanceMultiple

IoWMISetNotificationCallback

IoWMISetSingleInstance

IoWMISetSingleItem

ZwClose