DOCERR: Error 87 When NetMessageBufferSend Attempts Broadcast
  
PSS ID Number: Q129289
Article last modified on 09-29-1995
 
3.50
 
WINDOWS NT
 

---------------------------------------------------------------------
The information in this article applies to:
 
 - Microsoft Win32 Software Development Kit (SDK) for Windows NT
   version 3.5
---------------------------------------------------------------------
 
SUMMARY
=======
 
The documentation incorrectly states that applications may use
NetMessageBufferSend() to send broadcast messages on the network. This API
does not support broadcasts. If an application calls the
NetMessageBufferSend() API with the second parameter set to "L"*"", the API
fails with error 87 (Invalid Parameter). The "*" parameter is used to
broadcast a message to all the machines on the network.
 
MORE INFORMATION
================
 
Programmers can specify the domain name as the second parameter to send
broadcasts on a particular domain. For example:
 
   NetMessageBufferSend(NULL, // Run command on local machine.
              L"MYDOMAIN*",   // Domain name.
              L"MYNAME",      // Sender of message.
              buffer,         // Buffer to send.
              buflen);        // Size of buffer.
 
If broadcasts are necessary, use the NetServerEnum() or WNetOpenEnum() API
in conjunction with the WNetEnumResource() API to list domains, and use the
NetMessageBufferSend() API to send a message on each domain as shown above.
 
REFERENCES
==========
 
"Message APIs" help file in the Windows Networking API Definitions
section of the online "Win32 SDK Programmer's Reference."
 
Additional reference words: 3.50
KBCategory: kbnetwork kbdocerr
KBSubcategory: NtwkLmapi
=============================================================================
Copyright Microsoft Corporation 1995.
