Microsoft KB Archive/129289

DOCERR: Error 87 When NetMessageBufferSend Attempts Broadcast

PSS ID Number: Q129289 Article last modified on 09-29-1995

3.50

WINDOWS NT

= 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”''&quot;“, the API fails with error 87 (Invalid Parameter). The”''&quot; 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&quot;MYDOMAIN*“, // Domain name. L”MYNAME&quot;, // 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.