Compartir a través de

Función PdhValidatePathExW (pdh.h)

  • Artículo

Valida que el contador especificado está presente en el equipo o en el archivo de registro.

Sintaxis

PDH_FUNCTION PdhValidatePathExW(
  [in, optional] PDH_HLOG hDataSource,
  [in]           LPCWSTR  szFullPathBuffer
);

Parámetros

[in, optional] hDataSource

Identificador del origen de datos. Las funciones PdhOpenLog y PdhBindInputDataSource devuelven este identificador.

Para validar que el contador está presente en el equipo local, especifique NULL (es el mismo que llamar a PdhValidatePath).

[in] szFullPathBuffer

Cadena terminada en NULL que especifica 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
 El contador especificado no se encontró en el objeto de rendimiento.
PDH_CSTATUS_NO_OBJECT
 El objeto de rendimiento especificado no se encontró en el equipo o en el archivo de registro.
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.

Comentarios

Nota

El encabezado pdh.h define PdhValidatePathEx 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 Vista [solo aplicaciones de escritorio]
Servidor mínimo compatible Windows Server 2008 [solo aplicaciones de escritorio]
Plataforma de destino Windows
Encabezado pdh.h
Library Pdh.lib
Archivo DLL Pdh.dll

Consulte también

PdhMakeCounterPath

PdhValidatePath