Función PdhValidatePathA (pdh.h)

Valida que el contador está presente en el equipo especificado en la ruta de acceso del contador.

Sintaxis

PDH_FUNCTION PdhValidatePathA(
  [in] LPCSTR szFullPathBuffer
);

Parámetros

[in] szFullPathBuffer

Cadena terminada en NULL que contiene la ruta de acceso del contador que se va a validar. La longitud máxima de una ruta de acceso de contador es PDH_MAX_COUNTER_PATH.

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 muestran los valores posibles.

Código devuelto	Descripción
PDH_CSTATUS_NO_INSTANCE	No se encontró la instancia especificada del objeto de rendimiento.
PDH_CSTATUS_NO_COUNTER	No se encontró el contador especificado en el objeto de rendimiento.
PDH_CSTATUS_NO_OBJECT	No se encontró el objeto de rendimiento especificado en el equipo.
PDH_CSTATUS_NO_MACHINE	No se pudo encontrar ni conectar el equipo especificado.
PDH_CSTATUS_BAD_COUNTERNAME	No se pudo analizar la cadena de ruta de acceso del contador.
PDH_MEMORY_ALLOCATION_FAILURE	La función no puede asignar un búfer temporal necesario.

Observaciones

Nota

El encabezado pdh.h define PdhValidatePath 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

PdhMakeCounterPath