Funzione PdhLookupPerfIndexByNameA (pdh.h)

Articolo
11/20/2024

Restituisce l'indice del contatore corrispondente al nome del contatore specificato.

Sintassi

PDH_FUNCTION PdhLookupPerfIndexByNameA(
  [in]  LPCSTR  szMachineName,
  [in]  LPCSTR  szNameBuffer,
  [out] LPDWORD pdwIndex
);

Parametri

[in] szMachineName

Nullstringa con terminazione che specifica il nome del computer in cui si trova il contatore specificato. Il nome del computer può essere specificato dal nome DNS o dall'indirizzo IP. Se NULL, la funzione usa il computer locale.

[in] szNameBuffer

nullstringa con terminazione contenente il nome del contatore.

[out] pdwIndex

Indice del contatore.

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 è riportato un valore possibile.

Codice restituito	Descrizione
PDH_INVALID_ARGUMENT	Un parametro non è valido o non è formattato correttamente.

Osservazioni

Nota

L'intestazione pdh.h definisce PdhLookupPerfIndexByName 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

PdhLookupPerfNameByIndex

Condividi tramite