Microsoft KB Archive Search

Notice: This website is an unofficial Microsoft Knowledge Base (hereinafter KB) archive and is intended to provide a reliable access to deleted content from Microsoft KB. All KB articles are owned by Microsoft Corporation. Read full disclaimer for more details.

  1. Home
  2. PRB: ERROR_INVALID_PARAMETER from WriteFile() or ReadFile()

PRB: ERROR_INVALID_PARAMETER from WriteFile() or ReadFile()

View products that this article applies to.

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.

↑ Back to the top

Cause

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

↑ Back to the top

Resolution

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

↑ Back to the top

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.

↑ Back to the top

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.

↑ Back to the top

Keywords: kbapi, kbdsupport, kbipc, kbkernbase, kbnetwork, kbpipes, kbprb, kbbillprodsweep, kb

↑ Back to the top

Article Info
Article ID : 110148
Revision : 2
Created on : 8/1/2019
Published on : 8/1/2019
Exists online : False
Views : 170