Platform and Performance Considerations

Platform and Performance Considerations

Mailslots on Windows 95, Windows 98, and Windows Me platforms have three limitations that you should be aware of: 8.3-character name limits, inability to cancel blocking I/O requests, and timeout memory leaks.

8.3-Character Name Limits

Windows 95, Windows 98, and Windows Me platforms silently limit mailslot names to an 8.3-character name format. This causes interoperability problems between Windows 95, Windows 98, Windows Me, and Windows NT. For example, if you create or open a mailslot with the name \\.\Mailslot\Mymailslot, Windows 95, Windows 98, and Windows Me will actually create and reference the mailslot as \\.\Mailslot\Mymailsl. The CreateMailslot and CreateFile functions succeed even though name truncation occurs. If a message is sent from Windows NT to Windows 95, Windows 98, or Windows Me, or vice versa, the message will not be received because the mailslot names do not match. If both the client and the server are running on Windows 95, Windows 98, or Windows Me machines, there isn't a problem—the name is truncated on both the client and the server. An easy way to prevent interoperability problems is to limit mailslot names to eight characters or less.

Inability to Cancel Blocking I/O Requests

Windows 95, Windows 98, and Windows Me platforms also have a problem with canceling blocking I/O requests. Mailslot servers use the ReadFile function to receive data. If a mailslot is created with the MAILSLOT_WAIT_FOREVER flag, read requests block indefinitely until data is available. If a server application is terminated when there is an outstanding ReadFile request, the application hangs forever. The only way to cancel the application is to reboot Windows. A possible solution is to have the server open a handle to its own mailslot in a separate thread and send data to break the blocking read request. The following code demonstrates this solution in detail:

// Server2.cpp #include <windows.h> #include <stdio.h> #include <conio.h> BOOL StopProcessing; DWORD WINAPI ServeMailslot(LPVOID lpParameter); void SendMessageToMailslot(void); void main(void) {     DWORD ThreadId;     HANDLE MailslotThread;     StopProcessing = FALSE;     MailslotThread = CreateThread(NULL, 0, ServeMailslot, NULL,         0, &ThreadId);     printf("Press a key to stop the server\n");     _getch();     // Mark the StopProcessing flag to TRUE so that when ReadFile      // breaks, our server thread will end     StopProcessing = TRUE;     // Send a message to our mailslot to break the ReadFile call     // in our server      SendMessageToMailslot();     // Wait for our server thread to complete     if (WaitForSingleObject(MailslotThread, INFINITE) == WAIT_FAILED)     {         printf("WaitForSingleObject failed with error %d\n",             GetLastError());         return;     } } // // Function: ServeMailslot // // Description: //     This function is the mailslot server worker function to  //     process all incoming mailslot I/O // DWORD WINAPI ServeMailslot(LPVOID lpParameter) {     char buffer[2048];     DWORD NumberOfBytesRead;     DWORD Ret;     HANDLE Mailslot;     if ((Mailslot = CreateMailslot("\\\\.\\mailslot\\myslot", 2048,         MAILSLOT_WAIT_FOREVER, NULL)) == INVALID_HANDLE_VALUE)     {         printf("Failed to create a MailSlot %d\n", GetLastError());         return 0;     }     while((Ret = ReadFile(Mailslot, buffer, 2048,         &NumberOfBytesRead, NULL)) != 0)     {         if (StopProcessing)             break;         printf("Received %d bytes\n", NumberOfBytesRead);     }     CloseHandle(Mailslot);     return 0; } // // Function: SendMessageToMailslot // // Description: //     The SendMessageToMailslot function is designed to send a //     simple message to our server so we can break the blocking //     ReadFile API call // void SendMessageToMailslot(void) {     HANDLE Mailslot;     DWORD BytesWritten;     if ((Mailslot = CreateFile("\\\\.\\mailslot\\myslot",          GENERIC_WRITE, FILE_SHARE_READ, NULL, OPEN_EXISTING,          FILE_ATTRIBUTE_NORMAL, NULL)) == INVALID_HANDLE_VALUE)     {         printf("CreateFile failed with error %d\n", GetLastError());         return;     }     if (WriteFile(Mailslot, "STOP", 4, &BytesWritten, NULL) == 0)     {         printf("WriteFile failed with error %d\n", GetLastError());         return;     }     CloseHandle(Mailslot); }

Timeout Memory Leaks

The final problem with Windows 95, Windows 98, and Windows Me platforms worth mentioning is memory leaks, which can occur when you're using timeout values on mailslots. When you create a mailslot using the CreateMailslot function with a timeout value greater than 0, the ReadFile function leaks memory when the timeout expires and the function returns FALSE. After many calls to the ReadFile function, the system becomes unstable and subsequent ReadFile calls with timers that expire start returning TRUE. As a result, the system is no longer able to execute other MS-DOS applications. To work around this, create the mailslot with a timeout value of either 0 or MAILSLOT_WAIT_FOREVER. This prevents an application from using the timeout mechanism, which causes the actual memory leak.

The Microsoft knowledge base documents the following problems and limitations. You can access the knowledge base at http://support.microsoft.com/support/search. We briefly describe each issue here.

• Q139715 ReadFile Returns Wrong Error Code for Mailslots

  If a server opens a mailslot using CreateMailslot, specifies a timeout, and then uses ReadFile to receive data, the ReadFile fails if no data is available. GetLastError returns an error code of 5 (access denied).

• Q192276 GetMailslotInfo Returns Incorrect lpNextSize Value

  If you call the API function GetMailslotInfo under Windows 95 OEM Service Release 2 (OSR2) or Windows 98 without a network client component installed, you receive an incorrect value (usually in the millions) or a negative number for the lpNextSize parameter. If you repeatedly call the function, it usually returns the correct value.

• Q170581 Mailslot Created on Win95 Allows Only 4093 Bytes

  If you call the WriteFile API function to write more than 4093 bytes to a mailslot that has been created on a Windows 95 workstation, it fails.

• Q131493 CreateFile and Mailslots

  The documentation for the CreateFile API function incorrectly describes the possible values that CreateFile returns when opening a client end of a mailslot.