Función PdhGetDefaultPerfCounterW (pdh.h)
Recupera el nombre del contador predeterminado para el objeto especificado. Este nombre se puede usar para establecer la selección del contador inicial en el cuadro de diálogo Examinar contador.
Para usar identificadores para orígenes de datos, use la función PdhGetDefaultPerfCounterH .
Sintaxis
PDH_FUNCTION PdhGetDefaultPerfCounterW(
[in] LPCWSTR szDataSource,
[in] LPCWSTR szMachineName,
[in] LPCWSTR szObjectName,
[out] LPWSTR szDefaultCounterName,
[in, out] LPDWORD pcchBufferSize
);
Parámetros
[in] szDataSource
Debe ser NULL.
Si especifica un archivo de registro, szDefaultCounterName será una cadena nula .
[in] szMachineName
Cadena terminada en NULL que especifica el nombre del equipo utilizado para comprobar el nombre del objeto. Si es NULL, el equipo local se usa para comprobar el nombre del objeto.
[in] szObjectName
Cadena terminada en NULL que especifica el nombre del objeto cuyo nombre de contador predeterminado desea recuperar.
[out] szDefaultCounterName
Búfer asignado por el autor de la llamada que recibe el nombre del contador predeterminado terminado en null. Se establece en NULL si pcchBufferSize es cero.
[in, out] pcchBufferSize
Tamaño del búfer szDefaultCounterName , 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.
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 szDefaultCounterName 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. |
|
Un parámetro obligatorio no es válido. 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. |
|
No se puede asignar memoria para completar la función. |
|
El equipo especificado está sin conexión o no está disponible. |
|
No se puede leer ni encontrar el nombre del contador predeterminado. |
|
No se encontró el objeto especificado. |
|
El objeto no especificó un contador predeterminado. |
Comentarios
Debe llamar a esta función dos veces, la primera vez que obtenga el tamaño de búfer necesario (establezca szDefaultCounterName en NULL y pcchBufferSize en 0) y la segunda vez para obtener los datos.
Nota:
El encabezado pdh.h define PdhGetDefaultPerfCounter 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
| 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 |