Función AddMonitor
La función AddMonitor instala un monitor de puerto local y vincula la configuración, los datos y los archivos de supervisión.
Sintaxis
BOOL AddMonitor(
_In_ LPTSTR pName,
_In_ DWORD Level,
_In_ LPBYTE pMonitors
);
Parámetros
-
pName [in]
-
Puntero a una cadena terminada en null que especifica el nombre del servidor en el que se debe instalar el monitor. Para los sistemas que solo admiten la instalación local de monitores, esta cadena debe ser NULL.
-
Nivel [in]
-
Versión de la estructura a la que apunta pMonitors . Este valor debe ser 2.
-
pMonitors [in]
-
Puntero a una estructura de MONITOR_INFO_2 . Si el miembro pEnvironment de la estructura pMonitors es NULL, se usa el entorno actual del autor de la llamada (cliente), no del destino (servidor).
Tenga en cuenta que se producirá un error en la llamada si el entorno no coincide con el entorno del servidor, es decir, solo puede agregar un monitor escrito para la arquitectura del servidor.
Valor devuelto
Si la función se ejecuta correctamente, el valor devuelto es un valor distinto de cero.
Si la función no se realiza correctamente, el valor devuelto es cero.
Comentarios
Nota
Se trata de una función de bloqueo o sincrónica que podría no devolverse inmediatamente. La rapidez con la que devuelve esta función depende de factores en tiempo de ejecución, como el estado de red, la configuración del servidor de impresión y los factores de implementación del controlador de impresora que son difíciles de predecir al escribir una aplicación. Llamar a esta función desde un subproceso que administra la interacción con la interfaz de usuario podría hacer que la aplicación parezca que no responde.
El autor de la llamada debe tener SeLoadDriverPrivilege.
Antes de que una aplicación llame a la función AddMonitor , todos los archivos requeridos por el monitor se deben copiar en el directorio SYSTEM32.
Para determinar los monitores de puerto que están instalados actualmente, llame a la función EnumMonitors .
Para quitar un monitor agregado por AddMonitor, llame a la función DeleteMonitor .
Requisitos
| Requisito | Value |
|---|---|
| Cliente mínimo compatible |
Windows 2000 Professional [solo aplicaciones de escritorio] |
| Servidor mínimo compatible |
Windows 2000 Server [solo aplicaciones de escritorio] |
| Encabezado |
|
| Biblioteca |
|
| Archivo DLL |
|
| Nombres Unicode y ANSI |
AddMonitorW (Unicode) y AddMonitorA (ANSI) |