Función DeleteMonitor

La función DeleteMonitor quita un monitor de puerto agregado por la función AddMonitor .

Sintaxis

BOOL DeleteMonitor(
  _In_ LPTSTR pName,
  _In_ LPTSTR pEnvironment,
  _In_ LPTSTR pMonitorName
);

Parámetros

pName [in]

Puntero a una cadena terminada en null que especifica el nombre del servidor del que se va a quitar el monitor. Si este parámetro es NULL, el monitor de puerto se quita localmente.

pEnvironment [in]

Puntero a una cadena terminada en null que especifica el entorno desde el que se va a quitar el monitor (por ejemplo, Windows x86, Windows IA64 o Windows x64). Si este parámetro es NULL, el monitor se quita del entorno actual de la aplicación que realiza la llamada y el equipo cliente (no de la aplicación de destino ni del servidor de impresión).

pMonitorName [in]

Puntero a una cadena terminada en null que especifica el nombre del monitor que se va a quitar.

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 y 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 de controladores 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.

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	Winspool.h (incluye Windows.h)
Biblioteca	Winspool.lib
Archivo DLL	Winspool.drv
Nombres Unicode y ANSI	DeleteMonitorW (Unicode) y DeleteMonitorA (ANSI)

Consulte también

Impresión

Funciones de la API del administrador de trabajos de impresión

AddMonitor