PRB: TransactNamedPipe() Returns Error 230 (140022)


The information in this article applies to:

  • Microsoft Win32 Software Development Kit (SDK) 3.5
  • Microsoft Win32 Software Development Kit (SDK) 3.51
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.
Modification Type:MajorLast Reviewed:10/29/2003
Keywords:kbAPI kbIPC kbnetwork kbPipes kbprb KB140022
©2003 Microsoft Corporation. All rights reserved.