Knowledge Base

PRB: TransactNamedPipe() Returns Error 230

Article ID: 140022

Article Last Modified on 10/29/2003


APPLIES TO


This article was previously published under Q140022

SYMPTOMS

When you use Named Pipes and run the client and server on the same computer, if TransactNamedPipe() is called from the client side, the error code returned is 230 (the pipe state is invalid).

CAUSE

The client side is running in byte mode as opposed to message mode as required by TransactNamedPipe().

RESOLUTION

Use SetNamedPipeHandleState() to set the pipe mode to message mode on the client side.

STATUS

This behavior is by design.

MORE INFORMATION

If the client and server are running on the same computer, it is possible to open the client side without explicitly specifying the computer name using this format:

   \\.\pipe\test
				


This is processed by the Named Pipe File System (NPFS), which defaults to byte mode. For this reason, if SetNamedPipeClientHandle() is not called on the client side, calling TransactNamedPipe() will fail with the error 230.

Instead of using the previous format, a client application running on the same computer (or on a different computer) can use the computer name as shown here:

   \\Server\pipe\test
				


When the computer name is used like this, the request is processed through the redirector, which defaults to message mode. Therefore, a call to SetNamedPipeHandleState() is not required.

Please note that a robust application should call SetNamedPipeHandleState() even if the client is running on a different computer or using the computer name if running on the same computer.

Keywords: kbapi kbpipes kbnetwork kbipc kbprb KB140022