Función PdhGetRawCounterArrayW (pdh.h)
Devuelve una matriz de valores sin formato del contador especificado. Use esta función cuando desee recuperar los valores de contador sin formato de un contador que contenga un carácter comodín para el nombre de instancia.
Sintaxis
PDH_FUNCTION PdhGetRawCounterArrayW(
[in] PDH_HCOUNTER hCounter,
[in, out] LPDWORD lpdwBufferSize,
[out] LPDWORD lpdwItemCount,
[out] PPDH_RAW_COUNTER_ITEM_W ItemBuffer
);
Parámetros
[in] hCounter
Identificador del contador para cuyos valores de instancia sin procesar actuales desea recuperar. La función PdhAddCounter devuelve este identificador.
[in, out] lpdwBufferSize
Tamaño del búfer ItemBuffer , 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.
[out] lpdwItemCount
Número de valores de contador sin formato en el búfer ItemBuffer .
[out] ItemBuffer
Búfer asignado por el autor de la llamada que recibe la matriz de estructuras de PDH_RAW_COUNTER_ITEM ; las estructuras contienen los valores del contador de instancia sin formato. Se establece en NULL si lpdwBufferSize es 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 |
---|---|
|
El búfer ItemBuffer no es lo suficientemente grande como para contener el nombre del objeto. Este valor devuelto se espera si lpdwBufferSize 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. |
|
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. |
|
El identificador de contador no es válido. |
Comentarios
Debe llamar a esta función dos veces, la primera vez que obtenga el tamaño de búfer necesario (establezca ItemBuffer en NULL y lpdwBufferSize en 0) y la segunda vez para obtener los datos.
Los datos del contador se bloquean durante la llamada a PdhGetRawCounterArray para evitar cualquier cambio durante el procesamiento de la llamada.
Nota
El encabezado pdh.h define PdhGetRawCounterArray 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
Comentarios
https://aka.ms/ContentUserFeedback.
Próximamente: A lo largo de 2024 iremos eliminando gradualmente GitHub Issues como mecanismo de comentarios sobre el contenido y lo sustituiremos por un nuevo sistema de comentarios. Para más información, vea:Enviar y ver comentarios de