Función PdhLookupPerfIndexByNameA (pdh.h)

  • Artículo

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 NULL que 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 es NULL, la función usa el equipo local.

[in] szNameBuffer

Cadena terminada en NULL que 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.

Comentarios

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 neutro de codificación con código que no es neutral de codificación puede provocar discrepancias que dan lugar a errores de compilación o en tiempo de ejecución. Para obtener más información, vea Convenciones para prototipos de función.

Requisitos

Requisito Value
Cliente mínimo compatible Windows XP [solo aplicaciones de escritorio]
Servidor mínimo compatible Windows Server 2003 [solo aplicaciones de escritorio]
Plataforma de destino Windows
Encabezado pdh.h
Library Pdh.lib
Archivo DLL Pdh.dll

Consulte también

PdhLookupPerfNameByIndex