Função DisconnectNamedPipe (namedpipeapi.h)

Artigo
02/29/2024

Desconecta a extremidade do servidor de uma instância de pipe nomeado de um processo de cliente.

Sintaxe

BOOL DisconnectNamedPipe(
  [in] HANDLE hNamedPipe
);

Parâmetros

[in] hNamedPipe

Um identificador para uma instância de um pipe nomeado. Esse identificador deve ser criado pela função CreateNamedPipe .

Valor retornado

Se a função for bem-sucedida, o valor retornado será diferente de zero.

Se a função falhar, o valor retornado será zero. Para obter informações de erro estendidas, chame GetLastError.

Comentários

Se a extremidade do cliente do pipe nomeado estiver aberta, a função DisconnectNamedPipe forçará essa extremidade do pipe nomeado fechado. O cliente recebe um erro na próxima vez que tentar acessar o pipe. Um cliente que é forçado a sair de um pipe pelo DisconnectNamedPipe ainda deve usar a função CloseHandle para fechar a extremidade do pipe.

O pipe existe desde que um processo de servidor ou cliente tenha um identificador aberto para o pipe.

Quando o processo do servidor desconecta uma instância de pipe, todos os dados não lidos no pipe são descartados. Antes de desconectar, o servidor pode garantir que os dados não sejam perdidos chamando a função FlushFileBuffers , que não retorna até que o processo do cliente leia todos os dados.

O processo do servidor deve chamar DisconnectNamedPipe para desconectar um identificador de pipe de seu cliente anterior antes que o identificador possa ser conectado a outro cliente usando a função ConnectNamedPipe .

Windows 10, versão 1709: os pipes só têm suporte em um app-container; ou seja, de um processo UWP para outro processo UWP que faz parte do mesmo aplicativo. Além disso, os pipes nomeados devem usar a sintaxe \\.\pipe\LOCAL\ para o nome do pipe.

Exemplos

Para obter um exemplo, consulte Servidor de Pipe Multithreaded.

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Windows 2000 Professional [aplicativos da área de trabalho \| Aplicativos UWP]
Servidor mínimo com suporte	Windows 2000 Server [aplicativos da área de trabalho \| Aplicativos UWP]
Plataforma de Destino	Windows
Cabeçalho	namedpipeapi.h
Biblioteca	Kernel32.lib
DLL	Kernel32.dll