Condividi tramite


Funzione PerfOpenQueryHandle (perflib.h)

Crea un handle che fa riferimento a una query nel sistema specificato. Una query è un elenco di specifiche dei contatori.

Sintassi

ULONG PerfOpenQueryHandle(
  [in, optional] LPCWSTR szMachine,
  [out]          HANDLE  *phQuery
);

Parametri

[in, optional] szMachine

Nome del computer per cui si desidera ottenere l'handle di query.

[out] phQuery

Handle per la query. Chiamare PerfCloseQueryHandle per chiudere l'handle quando non è più necessario.

Valore restituito

Se la funzione ha esito positivo, restituisce ERROR_SUCCESS.

Se la funzione ha esito negativo, il valore restituito è un codice di errore di sistema.

Commenti

Usare PerfAddCounters e PerfDeleteCounters per aggiungere o rimuovere specifiche dei contatori all'elenco. Usare PerfQueryCounterInfo per ottenere le specifiche del contatore attualmente nell'elenco e per determinare gli indici in cui verranno restituiti i dati per ogni contatore da PerfQueryCounterData. Usare PerfQueryCounterData per recuperare i valori dei contatori che corrispondono alle specifiche del contatore.

Requisiti

Requisito Valore
Client minimo supportato Windows 10 versione 1607 [solo app desktop]
Server minimo supportato Windows Server 2016 [solo app desktop]
Piattaforma di destinazione Windows
Intestazione perflib.h
Libreria AdvAPI32.lib
DLL AdvAPI32.dll

Vedi anche

PerfAddCounters

PerfCloseQueryHandle

PerfDeleteCounters

PerfQueryCounterData

PerfQueryCounterInfo