Función ConfigurePort
La función ConfigurePort muestra el cuadro de diálogo configuración de puerto para un puerto en el servidor especificado.
Sintaxis
BOOL ConfigurePort(
_In_ LPTSTR pName,
_In_ HWND hWnd,
_In_ LPTSTR pPortName
);
Parámetros
-
pName [in]
-
Puntero a una cadena terminada en null que especifica el nombre del servidor en el que existe el puerto especificado. Si este parámetro es NULL, el puerto es local.
-
hWnd [in]
-
Identificador de la ventana primaria del cuadro de diálogo configuración de puerto.
-
pPortName [in]
-
Puntero a una cadena terminada en null que especifica el nombre del puerto que se va a configurar.
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.
Antes de llamar a la función ConfigurePort , una aplicación debe llamar a la función EnumPorts para determinar los nombres de puerto válidos.
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 |
ConfigurePortW (Unicode) y ConfigurePortA (ANSI) |