Microsoft KB Archive/110148

{|
 * width="100%"|

PRB: ERROR_INVALID_PARAMETER from WriteFile or ReadFile

 * }

Q110148

-

The information in this article applies to:


 * Microsoft Win32 Application Programming Interface (API), included with:
 * Microsoft Windows NT Server versions 3.5, 3.51, 4.0
 * Microsoft Windows NT Workstation versions 3.5, 3.51, 4.0
 * Microsoft Windows 95
 * the operating system: Microsoft Windows 2000

-

SYMPTOMS
The WriteFile or ReadFile function call may fail with the error

ERROR_INVALID_PARAMETER

if you are operating on a named pipe and using overlapped I/O.

CAUSE
A possible cause for the failure is that the Offset and OffsetHigh members of the OVERLAPPED structure are not set to zero.

RESOLUTION
Set the Offset and OffsetHigh members of your OVERLAPPED structure to zero.

STATUS
This behavior is by design. The online help for both WriteFile and ReadFile state that the Offset and OffsetHigh members of the OVERLAPPED structure must be set to zero or the functions will fail.

MORE INFORMATION
In many cases the function calls may succeed if you do not explicitly set OVERLAPPED.Offset and OVERLAPPED.OffsetHigh to zero. However, this is usually either because the OVERLAPPED structure is static or global and therefore is initialized to zero, or the OVERLAPPED structure is automatic (local) and the contents of that location on the stack are already zero. You should explicitly set the OVERLAPPED.Offset and OVERLAPPED.OffsetHigh structure members to zero.

Additional query words:

Keywords : kbnetwork kbAPI kbIPC kbKernBase kbOSWin2000 kbPipes kbSDKPlatform kbDSupport kbGrpDSNet kbGrpDSKernBase

Issue type : kbprb

Technology : kbAudDeveloper kbWin32sSearch kbWin32API