Funzione PerfQueryInstance (perflib.h)

Recupera un puntatore all'istanza del set di contatori specificata. I provider usano questa funzione.

Sintassi

PPERF_COUNTERSET_INSTANCE PerfQueryInstance(
  [in] HANDLE  ProviderHandle,
  [in] LPCGUID CounterSetGuid,
  [in] PCWSTR  Name,
  [in] ULONG   Id
);

Parametri

[in] ProviderHandle

Handle del provider. Usare la variabile handle generata automaticamente dallo strumento CTRPP . Per il nome della variabile, vedere l'attributo symbol dell'elemento provider .

Windows Vista: La funzione PerfStartProvider restituisce l'handle.

[in] CounterSetGuid

GUID che identifica in modo univoco il set di contatori su cui si vuole eseguire una query. Si tratta dello stesso GUID specificato nell'attributo guid dell'elemento counterSet . Usare la variabile GUID generata automaticamente dallo strumento CTRPP . Per il nome della variabile, vedere l'attributo symbol dell'elemento counterSet .

Windows Vista: La variabile GUID non è disponibile.

[in] Name

Stringa Unicode con terminazione Null contenente il nome dell'istanza del set di contatori che si desidera recuperare.

[in] Id

Identificatore univoco dell'istanza del set di contatori da recuperare.

Valore restituito

Struttura PERF_COUNTERSET_INSTANCE che contiene l'istanza del set di contatori o NULL se l'istanza non esiste.

Questa funzione restituisce NULL se si è verificato un errore. Per determinare l'errore che si è verificato, chiamare GetLastError.

Commenti

Usare lo stesso nome dell'istanza e l'identificatore usati durante la chiamata a PerfCreateInstance per recuperare un'istanza specifica del set di contatori.

I provider devono memorizzare nella cache il puntatore all'istanza quando creano l'istanza anziché chiamare questa funzione per recuperare il puntatore.

Requisiti

Vedi anche

PerfCreateInstance