Función PdhMakeCounterPathA (pdh.h)

Crea una ruta de acceso de contador completa mediante los miembros especificados en la estructura PDH_COUNTER_PATH_ELEMENTS.

Sintaxis

PDH_FUNCTION PdhMakeCounterPathA(
  [in]      PPDH_COUNTER_PATH_ELEMENTS_A pCounterPathElements,
  [out]     LPSTR                        szFullPathBuffer,
  [in, out] LPDWORD                      pcchBufferSize,
  [in]      DWORD                        dwFlags
);

Parámetros

[in] pCounterPathElements

Estructura PDH_COUNTER_PATH_ELEMENTS que contiene los miembros usados para crear la ruta de acceso. Solo se requieren los miembros szObjectNamey szCounterName, los demás son opcionales.

Si el miembro de nombre de instancia es null, la ruta de acceso no contendrá una referencia de instancia y se omitirán los miembros de szParentInstance y dwInstanceIndex.

[out] szFullPathBuffer

Búfer asignado por el autor de la llamada que recibe un ruta de acceso de contador terminadanull. La longitud máxima de una ruta de acceso de contador es PDH_MAX_COUNTER_PATH. Establézcalo en NULL si pcchBufferSize es cero.

[in, out] pcchBufferSize

Tamaño del búfer de de szFullPathBuffer, en TCHAR. 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.

[in] dwFlags

Formato de los valores del contador de entrada y salida. Puede especificar uno de los siguientes valores.

Valor	Significado
PDH_PATH_WBEM_RESULT	Convierte una ruta de acceso PDH al formato de nombre de propiedad y clase WMI.
PDH_PATH_WBEM_INPUT	Convierte el nombre de la propiedad y la clase WMI en una ruta de acceso PDH.
0	Devuelve la ruta de acceso en el formato PDH, por ejemplo, \\computer\object(parent/instance#index)\counter.

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_MORE_DATA	El búfer de szFullPathBuffer es demasiado pequeño para contener el nombre del contador. Este valor devuelto se espera si pcchBufferSize 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_ARGUMENT	Un parámetro no es válido o tiene un formato incorrecto. 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.

Observaciones

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

Nota

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

PDH_COUNTER_PATH_ELEMENTS

PdhParseCounterPath