Función AddPort

La función AddPort agrega el nombre de un puerto a la lista de puertos admitidos. El monitor de puertos exporta la función AddPort .

Sintaxis

BOOL AddPort(
  _In_ LPTSTR pName,
  _In_ HWND   hWnd,
  _In_ LPTSTR pMonitorName
);

Parámetros

pName [in]

Puntero a una cadena terminada en cero que especifica el nombre del servidor al que está conectado el puerto. Si este parámetro es NULL, el puerto es local.

hWnd [in]

Identificador de la ventana primaria del cuadro de diálogo AgregarPort .

pMonitorName [in]

Puntero a una cadena terminada en cero que especifica el monitor asociado al puerto.

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.

La función AddPort examina la red para buscar puertos existentes y muestra un cuadro de diálogo para el usuario. La función AddPort debe validar el nombre de puerto especificado por el usuario mediante una llamada a EnumPorts para asegurarse de que no existen nombres duplicados.

El autor de la llamada de la función AddPort debe tener SERVER_ACCESS_ADMINISTER acceso al servidor al que está conectado el puerto.

Para agregar un puerto sin mostrar un cuadro de diálogo, llame a la función XcvData en lugar de AddPort. Para obtener más información sobre XcvData, consulte el Kit de desarrollo de controladores de Microsoft Windows (DDK).

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	Spoolss.dll
Nombres Unicode y ANSI	AddPortW (Unicode) y AddPortA (ANSI)

Consulte también

Impresión

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

DeletePort

EnumPorts

SetPort