Este artículo se tradujo automáticamente. Para ver el artículo en inglés, active la casilla Inglés. Además, puede mostrar el texto en inglés en una ventana emergente si mueve el puntero del mouse sobre el texto.
Traducción
Inglés

PerformanceCounterCategory::CounterExists (Método) (String^)

 

Determina si el contador especificado está registrado en esta categoría; esta información se indica mediante las propiedades CategoryName y MachineName.

Espacio de nombres:   System.Diagnostics
Ensamblado:  System (en System.dll)

public:
bool CounterExists(
	String^ counterName
)

Parámetros

counterName

Nombre del contador de rendimiento que se va a buscar.

Valor devuelto

Type: System::Boolean

Es true si el contador está registrado en la categoría especificada por las propiedades CategoryName y MachineName; de lo contrario, es false.

Exception Condition
ArgumentNullException

La propiedad counterName es null.

InvalidOperationException

No se ha establecido el valor de la propiedad CategoryName.

Win32Exception

Se ha producido un error en la llamada a una API del sistema subyacente.

UnauthorizedAccessException

Código que se ejecuta sin privilegios administrativos para intentar leer un contador de rendimiento.

Debe establecer la propiedad CategoryName antes de llamar a este método.De lo contrario, se producirá una excepción.

Si no se ha establecido la propiedad MachineName, este método utiliza el equipo local (".").

System_CAPS_noteNota

Para leer los contadores de rendimiento de Windows Vista y versiones posteriores, Windows XP Professional x64 Edition o Windows Server 2003, debe ser miembro del grupo Usuarios del monitor de sistema o tener privilegios administrativos.

Para evitar la elevación de los privilegios de acceso a los contadores de rendimiento en Windows Vista y versiones posteriores, agregue su propio usuario al grupo Usuarios del monitor de sistema.

En Windows Vista y posteriores, el Control de cuentas de usuario (UAC) determina los privilegios de un usuario.Si es miembro del grupo Administradores integrados, se le asignarán dos símbolos (tokens) de acceso en tiempo de ejecución: un símbolo (token) de acceso de usuario estándar y un símbolo (token) de acceso de administrador.De forma predeterminada, se le asignará el rol de usuario estándar.Para ejecutar el código que tiene acceso a los contadores de rendimiento, primero debe elevar el nivel de sus privilegios de usuario estándar a administrador.Podrá hacerlo cuando inicie una aplicación haciendo clic con el botón secundario en el icono de la aplicación e indicando que desea ejecutarla como administrador.

En el ejemplo de código siguiente se determina si existe un PerformanceCounter.Se obtiene un nombre de categoría, un nombre de contador y un nombre de equipo de la línea de comandos, si se han proporcionado.Se crea un objeto PerformanceCounterCategory mediante la sobrecarga PerformanceCounterCategoryadecuada.A continuación, se utiliza el método CounterExists(String) para determinar si existe el PerformanceCounter especificado y se informa al usuario.

No hay ningún ejemplo de código disponible o este idioma no es compatible.

.NET Framework
Disponible desde 1.1
Volver al principio
Mostrar: