Función DisconnectNamedPipe (namedpipeapi.h)
Desconecta el extremo del servidor de una instancia de canalización con nombre de un proceso de cliente.
Sintaxis
BOOL DisconnectNamedPipe(
[in] HANDLE hNamedPipe
);
Parámetros
[in] hNamedPipe
Identificador de una instancia de una canalización con nombre. La función CreateNamedPipe debe crear este identificador.
Valor devuelto
Si la función se realiza correctamente, el valor devuelto es distinto de cero.
Si la función no se realiza correctamente, el valor devuelto es cero. Para obtener información de error extendida, llame a GetLastError.
Comentarios
Si el final del cliente de la canalización con nombre está abierto, la función DisconnectNamedPipe fuerza ese final de la canalización con nombre cerrada. El cliente recibe un error la próxima vez que intenta acceder a la canalización. Un cliente forzado de una canalización por DisconnectNamedPipe debe seguir usando la función CloseHandle para cerrar el final de la canalización.
La canalización existe siempre que un servidor o proceso de cliente tenga un identificador abierto para la canalización.
Cuando el proceso del servidor desconecta una instancia de canalización, se descartan los datos no leídos de la canalización. Antes de desconectar, el servidor puede asegurarse de que los datos no se pierden llamando a la función FlushFileBuffers , que no devuelve hasta que el proceso del cliente haya leído todos los datos.
El proceso del servidor debe llamar a DisconnectNamedPipe para desconectar un identificador de canalización de su cliente anterior antes de que el identificador pueda conectarse a otro cliente mediante la función ConnectNamedPipe .
Windows 10, versión 1709: las canalizaciones solo se admiten en un contenedor de aplicaciones; es decir, desde un proceso de UWP a otro proceso de UWP que forma parte de la misma aplicación. Además, las canalizaciones con nombre deben usar la sintaxis \\.\pipe\LOCAL\ para el nombre de la canalización.
Ejemplos
Para obtener un ejemplo, vea Servidor de canalización multiproceso.
Requisitos
| Requisito | Value |
|---|---|
| Cliente mínimo compatible | Windows 2000 Professional [aplicaciones de escritorio | Aplicaciones para UWP] |
| Servidor mínimo compatible | Windows 2000 Server [aplicaciones de escritorio | Aplicaciones para UWP] |
| Plataforma de destino | Windows |
| Encabezado | namedpipeapi.h |
| Library | Kernel32.lib |
| Archivo DLL | Kernel32.dll |