Voltar à lista
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: NtFsControlFile

Assinatura

BOOL ConnectNamedPipe(HANDLE hNamedPipe, LPOVERLAPPED lpOverlapped);

Parâmetros

ParâmetroTipoDescrição
hNamedPipeHANDLEHandle da instância do pipe, criado com CreateNamedPipeW.
lpOverlappedLPOVERLAPPEDEstrutura 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.

Relacionadas