Funzione LoadPerfCounterTextStringsA (loadperf.h)

Carica nel computer gli oggetti prestazioni e i contatori definiti nel file di inizializzazione specificato.

Sintassi

LOADPERF_FUNCTION LoadPerfCounterTextStringsA(
  [in] LPSTR lpCommandLine,
  [in] BOOL  bQuietModeArg
);

Parametri

[in] lpCommandLine

Stringa con terminazione Null costituita da una o più lettere arbitrarie, uno spazio e quindi il nome del file di inizializzazione (.ini). Il nome può includere il percorso del file di inizializzazione.

La funzione usa solo il file di inizializzazione; il primo argomento viene rimosso. Ad esempio, per caricare un file di inizializzazione denominato "myfile.ini", la stringa della riga di comando potrebbe essere "xx myfile.ini". Le lettere prima dello spazio (qui "xx") vengono eliminate e la seconda parte, dopo lo spazio, viene interpretata come specifica del file di inizializzazione.

[in] bQuietModeArg

Impostare su TRUE per impedire alla funzione di visualizzare l'output dallo strumento Lodctr ; in caso contrario, FALSE. Questo parametro ha un significato solo se l'applicazione viene eseguita da un prompt dei comandi.

Valore restituito

Se la funzione ha esito positivo, restituisce ERROR_SUCCESS.

Se la funzione ha esito negativo, il valore restituito è uno dei codici di errore di sistema.

Commenti

Questa funzione fornisce un'API alla funzionalità fornita dallo strumento Lodctr . Per informazioni su Lodctr, vedere Aggiunta di nomi di contatori e descrizioni al Registro di sistema.

Nota

L'intestazione loadperf.h definisce LoadPerfCounterTextStrings 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 che non è indipendente dalla codifica può causare mancate corrispondenze che generano errori di compilazione o di runtime. Per altre informazioni, vedere Convenzioni per i prototipi di funzioni.

Requisiti

Requisito Valore
Client minimo supportato Windows XP [solo app desktop]
Server minimo supportato Windows Server 2003 [solo app desktop]
Piattaforma di destinazione Windows
Intestazione loadperf.h
Libreria Loadperf.lib
DLL Loadperf.dll

Vedi anche

UnloadPerfCounterTextStrings