Windows Win32IPCkernel32.dll
ConnectNamedPipe
No lado servidor, aguarda um cliente se conectar a uma instância de pipe nomeado.
Descrição
Análogo ao `accept` de sockets, mas para pipes nomeados.
Header:
namedpipeapi.hDLL: kernel32.dllNative API: NtFsControlFileAssinatura
BOOL ConnectNamedPipe(HANDLE hNamedPipe, LPOVERLAPPED lpOverlapped);Parâmetros
| Parâmetro | Tipo | Descrição |
|---|---|---|
| hNamedPipe | HANDLE | Handle da instância do pipe, criado com CreateNamedPipeW. |
| lpOverlapped | LPOVERLAPPED | Estrutura para espera assíncrona, ou NULL para bloquear. |
Valor de retorno
Diferente de zero em sucesso; 0 em erro (consulte GetLastError; ERROR_PIPE_CONNECTED indica que um cliente já havia se conectado).
Códigos de erro (GetLastError)
- ERROR_PIPE_CONNECTED(535)
- Há um processo do outro lado do pipe (retornado quando um cliente já estava conectado ao chamar ConnectNamedPipe).
- ERROR_IO_PENDING(997)
- A operação de E/S sobreposta (overlapped) foi enfileirada e será concluída de forma assíncrona.