Funzione PdhGetDataSourceTimeRangeW (pdh.h)

Articolo
11/20/2024

Determina l'intervallo di tempo, il numero di voci e, se applicabile, le dimensioni del buffer contenente i dati sulle prestazioni dall'origine di input specificata.

Per usare handle per le origini dati, usare la funzione PdhGetDataSourceTimeRangeH.

Sintassi

PDH_FUNCTION PdhGetDataSourceTimeRangeW(
  [in]  LPCWSTR        szDataSource,
  [out] LPDWORD        pdwNumEntries,
  [out] PPDH_TIME_INFO pInfo,
  [in]  LPDWORD        pdwBufferSize
);

Parametri

[in] szDataSource

Stringa con terminazione Null che specifica il nome di un file di log da cui vengono recuperate le informazioni sull'intervallo di tempo.

[out] pdwNumEntries

Numero di strutture nel buffer pInfo . Questa funzione raccoglie informazioni per un solo intervallo di tempo, quindi il valore è in genere 1 o zero se si è verificato un errore.

[out] pInfo

Struttura PDH_TIME_INFO che riceve l'intervallo di tempo.

[in] pdwBufferSize

Dimensioni della struttura PDH_TIME_INFO, in byte.

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.

Codice restituito	Descrizione
PDH_INVALID_ARGUMENT	Un parametro non è valido o non è formattato correttamente.
PDH_INVALID_HANDLE	L'handle del contatore non è valido.
PDH_DATA_SOURCE_IS_REAL_TIME	L'origine dati corrente è un'origine dati in tempo reale.

Osservazioni

Nota

L'intestazione pdh.h definisce PdhGetDataSourceTimeRange come alias che seleziona automaticamente la versione ANSI o Unicode di questa funzione in base alla definizione della costante del preprocessore UNICODE. La combinazione dell'utilizzo dell'alias indipendente dalla codifica con il codice non indipendente dalla codifica può causare mancate corrispondenze che generano errori di compilazione o di runtime. Per altre informazioni, vedere convenzioni di per i prototipi di funzioni.

Fabbisogno

Requisito	Valore
client minimo supportato	Windows XP [solo app desktop]
server minimo supportato	Windows Server 2003 [solo app desktop]
piattaforma di destinazione	Finestre
intestazione	pdh.h
libreria	Pdh.lib
dll	Pdh.dll

Vedere anche

PdhGetDataSourceTimeRangeH

PdhSetQueryTimeRange

Condividi tramite