Función PdhLookupPerfIndexByNameA (pdh.h)

Devuelve el índice de contador correspondiente al nombre de contador especificado.

Sintaxis

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

Parámetros

[in] szMachineName

cadena terminada en Nullque especifica el nombre del equipo donde se encuentra el contador especificado. El nombre del equipo se puede especificar mediante el nombre DNS o la dirección IP. Si null, la función usa el equipo local.

[in] szNameBuffer

cadena terminada en nullque contiene el nombre del contador.

[out] pdwIndex

Índice del contador.

Valor devuelto

Si la función se ejecuta correctamente, devuelve ERROR_SUCCESS.

Si se produce un error en la función, el valor devuelto es un código de error del sistema o un código de error PDH . A continuación se muestra un valor posible.

Código devuelto	Descripción
PDH_INVALID_ARGUMENT	Un parámetro no es válido o tiene un formato incorrecto.

Observaciones

Nota

El encabezado pdh.h define PdhLookupPerfIndexByName como alias que selecciona automáticamente la versión ANSI o Unicode de esta función en función de la definición de la constante de preprocesador UNICODE. La combinación del uso del alias neutral de codificación con código que no es neutral de codificación puede dar lugar a errores de coincidencia que dan lugar a errores de compilación o tiempo de ejecución. Para obtener más información, vea Conventions for Function Prototypes.

Requisitos

Requisito	Valor
cliente mínimo admitido	Windows XP [solo aplicaciones de escritorio]
servidor mínimo admitido	Windows Server 2003 [solo aplicaciones de escritorio]
de la plataforma de destino de	Windows
encabezado de	pdh.h
biblioteca de	Pdh.lib
DLL de	Pdh.dll

Consulte también

PdhLookupPerfNameByIndex