Funzione LoadPerfCounterTextStringsA (loadperf.h)

Articolo
11/20/2024

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 commandLine stringa 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 .

Osservazioni

Questa funzione fornisce un'API alla funzionalità fornita dallo strumento Lodctr . Per informazioni su Lodctr, vedere Aggiunta di nomi e descrizioni dei contatori 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 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	loadperf.h
libreria	Loadperf.lib
dll	Loadperf.dll

Vedere anche

unloadPerfCounterTextStrings

Condividi tramite