Compartir a través de

Función PdhParseCounterPathW (pdh.h)

  • Artículo

Analiza los elementos de la ruta de acceso del contador y almacena los resultados en la estructura PDH_COUNTER_PATH_ELEMENTS .

Sintaxis

PDH_FUNCTION PdhParseCounterPathW(
  [in]      LPCWSTR                      szFullPathBuffer,
  [out]     PPDH_COUNTER_PATH_ELEMENTS_W pCounterPathElements,
  [in, out] LPDWORD                      pdwBufferSize,
            DWORD                        dwFlags
);

Parámetros

[in] szFullPathBuffer

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

[out] pCounterPathElements

Búfer asignado por el autor de la llamada que recibe una estructura de PDH_COUNTER_PATH_ELEMENTS . La estructura contiene punteros a los elementos de cadena individuales de la ruta de acceso a la que hace referencia el parámetro szFullPathBuffer . La función anexa las cadenas al final de la estructura PDH_COUNTER_PATH_ELEMENTS . El búfer asignado debe ser lo suficientemente grande como para la estructura y las cadenas. Se establece en NULL si pdwBufferSize es cero.

[in, out] pdwBufferSize

Tamaño del búfer pCounterPathElements , en bytes. Si es cero en la entrada, la función devuelve PDH_MORE_DATA y establece este parámetro en el tamaño de búfer necesario. Si el búfer es mayor que el tamaño necesario, la función establece este parámetro en el tamaño real del búfer que se usó. Si el tamaño especificado en la entrada es mayor que cero pero menor que el tamaño necesario, no debe confiar en el tamaño devuelto para reasignar el búfer.

dwFlags

Reservado. Debe ser cero.

Valor devuelto

Si la función se realiza 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_INVALID_ARGUMENT
 Un parámetro no es válido.
PDH_MORE_DATA
 El búfer pCounterPathElements es demasiado pequeño para contener los elementos de ruta de acceso. Este valor devuelto se espera si pdwBufferSize es cero en la entrada. Si el tamaño especificado en la entrada es mayor que cero pero menor que el tamaño necesario, no debe confiar en el tamaño devuelto para reasignar el búfer.
PDH_INVALID_PATH
 La ruta de acceso no tiene el formato correcto y no se puede analizar. Por ejemplo, en algunas versiones podría recibir este error si el tamaño especificado en la entrada es mayor que cero pero menor que el tamaño necesario.
PDH_MEMORY_ALLOCATION_FAILURE
 No se puede asignar memoria para completar la función.

Comentarios

Debe llamar a esta función dos veces, la primera vez que obtenga el tamaño de búfer necesario (establezca pCounterPathElements en NULL y pdwBufferSize en 0) y la segunda vez para obtener los datos.

Nota

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

PDH_COUNTER_PATH_ELEMENTS

PdhMakeCounterPath