Microsoft KB Archive/86266

{|
 * width="100%"|

DOC: Overview Manual Documents PostAppMessage Incorrectly

 * }

Q86266

3.10 WINDOWS kbprg kbdocerr

-

The information in this article applies to:


 * Microsoft Windows Software Development Kit (SDK) 3.1

-

SUMMARY
Section 1.1.4 (page 10) of the &quot;Microsoft Windows Software Development Kit: Programmer's Reference, Volume 1: Overview&quot; manual for version 3.1 documents that the PostAppMessage function posts a message to an application using its module handle. This statement is incorrect; PostAppMessage posts a message to an application using its task handle.

MORE INFORMATION
Microsoft Windows makes a very important distinction between a task handle and a module handle. Each instance of an application has exactly one task, which consists of a stack, a message queue, and an execution state (CPU registers). However, all instances of an application share the same module, which consists of the application's executable code and resources.

One cannot post a message to a module for two reasons:


 * A module does not have a message queue; therefore, it cannot process a message.
 * Potentially, several application instances (tasks) share a module; therefore, a module handle does not identify a unique task to receive the message.

By posting a message to a task handle, the message is sent to only one instance of an application.

Additional query words: 3.10 SDK docerr

Keywords : kbdocfix kb16bitonly kbSDKPlatform kbWndw kbWndwMsg

Issue type :

Technology : kbAudDeveloper kbWin3xSearch kbSDKSearch kbWinSDKSearch kbWinSDK310