Funzione PdhEnumObjectItemsHA (pdh.h)

Restituisce i nomi dei contatori e delle istanze dell'oggetto specificati presenti nel computer specificato o nel file di log specificato.

Questa funzione è identica alla funzione pdhEnumObjectItems , ad eccezione del fatto che supporta l'uso di handle per le origini dati.

Sintassi

PDH_FUNCTION PdhEnumObjectItemsHA(
  [in]      PDH_HLOG hDataSource,
  [in]      LPCSTR   szMachineName,
  [in]      LPCSTR   szObjectName,
  [out]     PZZSTR   mszCounterList,
  [in, out] LPDWORD  pcchCounterListLength,
  [out]     PZZSTR   mszInstanceList,
  [in, out] LPDWORD  pcchInstanceListLength,
  [in]      DWORD    dwDetailLevel,
  [in]      DWORD    dwFlags
);

Parametri

[in] hDataSource

Handle in un'origine dati restituita dalla funzione PdhBindInputDataSource.

[in] szMachineName

Nullstringa con terminazione che specifica il nome del computer che contiene i nomi dei contatori e delle istanze da enumerare.

Includere le barre iniziali nel nome del computer, ad esempio \nomecomputer.

Se il parametro szDataSource è null, è possibile impostare szMachineName su NULL per specificare il computer locale.

[in] szObjectName

Nullstringa con terminazione che specifica il nome dell'oggetto i cui nomi di contatore e istanza da enumerare.

[out] mszCounterList

Buffer allocato dal chiamante che riceve un elenco di nomi di contatori nullcon terminazione forniti dall'oggetto specificato. L'elenco contiene nomi di contatori univoci. L'elenco viene terminato da due caratteri NULL. Impostare su NULL se il parametro pcchCounterListLength è zero.

[in, out] pcchCounterListLength

Dimensioni del buffer di mszCounterList , in TCHARs. Se zero per l'input e l'oggetto esiste, la funzione restituisce PDH_MORE_DATA e imposta questo parametro sulla dimensione del buffer richiesta. Se il buffer è maggiore delle dimensioni necessarie, la funzione imposta questo parametro sulle dimensioni effettive del buffer utilizzato. Se la dimensione specificata per l'input è maggiore di zero ma minore della dimensione richiesta, non è consigliabile basarsi sulle dimensioni restituite per riallocare il buffer.

[out] mszInstanceList

Buffer allocato dal chiamante che riceve un elenco di nullnomi di istanza con terminazione forniti dall'oggetto specificato. L'elenco contiene nomi di istanza univoci. L'elenco viene terminato da due caratteri NULL. Impostare su NULL se il parametro pcchInstanceListLength è zero.

[in, out] pcchInstanceListLength

Dimensioni del buffer di mszInstanceList, in TCHARs. Se zero per l'input e l'oggetto esiste, la funzione restituisce PDH_MORE_DATA e imposta questo parametro sulla dimensione del buffer richiesta. Se il buffer è maggiore delle dimensioni necessarie, la funzione imposta questo parametro sulle dimensioni effettive del buffer utilizzato. Se la dimensione specificata per l'input è maggiore di zero ma minore della dimensione richiesta, non è consigliabile basarsi sulle dimensioni restituite per riallocare il buffer.

Se l'oggetto specificato non supporta istanze variabili, il valore restituito sarà zero. Se l'oggetto specificato supporta istanze variabili, ma non dispone attualmente di istanze, il valore restituito è 2, ovvero la dimensione di una stringa di elenco MULTI_SZ vuota.

[in] dwDetailLevel

Livello di dettaglio degli elementi delle prestazioni da restituire. Verranno restituiti tutti gli elementi del livello di dettaglio specificato o meno (i livelli sono elencati in ordine crescente). Questo parametro può essere uno dei valori seguenti.

[in] dwFlags

Questo parametro deve essere zero.

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 o un codice di errore PDH . Di seguito sono riportati i valori possibili.

Osservazioni

È necessario chiamare questa funzione due volte, la prima volta per ottenere le dimensioni del buffer necessarie (impostare i buffer su NULL e le dimensioni su 0) e la seconda volta per ottenere i dati.

Le chiamate consecutive a questa funzione restituiranno elenchi identici di contatori e istanze, perché PdhEnumObjectItemsH eseguirà sempre una query sull'elenco di oggetti prestazioni definiti dall'ultima chiamata a PdhEnumObjectsH o PdhEnumObjectItemsH. Per aggiornare l'elenco degli oggetti prestazioni, chiamare PdhEnumObjectsH con un valore bRefresh flag di TRUE prima di chiamare di nuovo PdhEnumObjectItemsH.

L'ordine dei nomi dell'istanza e dei contatori non è determiniato.

Fabbisogno

Vedere anche

PdhBindInputDataSource

PdhEnumObjectsH