Клиент именованного канала

Клиент именованного канала использует функцию CreateFile для открытия дескриптора именованного канала. Если канал существует, но все его экземпляры заняты, CreateFile возвращает INVALID_HANDLE_VALUE , а функция GetLastError возвращает ERROR_PIPE_BUSY. В этом случае клиент именованного канала использует функцию WaitNamedPipe , чтобы дождаться появления экземпляра именованного канала.

Функция CreateFile завершается сбоем, если указанный доступ несовместим с указанным доступом (дуплексный, исходящий или входящий) при создании канала сервером. Для дуплексного канала клиент может указать доступ для чтения, записи или чтения и записи. для исходящего канала (сервера только для записи) клиент должен указать доступ только для чтения; и для входящего канала (сервер только для чтения) клиент должен указать доступ только для записи.

Дескриптор, возвращаемый CreateFile , по умолчанию использует режим чтения байтов, режим блокировки и ожидания, режим перекрытия отключен и режим записи через. Клиент канала может использовать CreateFile для включения перекрывающегося режима, указав FILE_FLAG_OVERLAPPED или режим записи, указав FILE_FLAG_WRITE_THROUGH. Клиент может использовать функцию SetNamedPipeHandleState , чтобы включить режим неблокировки, указав PIPE_NOWAIT или включить режим чтения сообщений, указав PIPE_READMODE_MESSAGE.

В следующем примере показан клиент канала, который открывает именованный канал, устанавливает дескриптор канала в режим чтения сообщений, использует функцию WriteFile для отправки запроса на сервер и использует функцию ReadFile для чтения ответа сервера. Этот клиент канала можно использовать с любым из серверов типа сообщений, перечисленных в нижней части этой статьи. Однако при использовании сервера типа байтов этот клиент канала завершается сбоем при вызове SetNamedPipeHandleState для перехода в режим чтения сообщений. Так как клиент считывает данные из канала в режиме чтения сообщений, операция ReadFile может возвращать ноль после чтения частичного сообщения. Это происходит, если размер сообщения превышает размер буфера чтения. В этом случае GetLastError возвращает ERROR_MORE_DATA, и клиент может прочитать оставшуюся часть сообщения с помощью дополнительных вызовов ReadFile.

Этот клиент канала можно использовать с любым сервером канала, перечисленным в разделе См. также.

#include <windows.h> 
#include <stdio.h>
#include <conio.h>
#include <tchar.h>

#define BUFSIZE 512
 
int _tmain(int argc, TCHAR *argv[]) 
{ 
   HANDLE hPipe; 
   LPTSTR lpvMessage=TEXT("Default message from client."); 
   TCHAR  chBuf[BUFSIZE]; 
   BOOL   fSuccess = FALSE; 
   DWORD  cbRead, cbToWrite, cbWritten, dwMode; 
   LPTSTR lpszPipename = TEXT("\\\\.\\pipe\\mynamedpipe"); 

   if( argc > 1 )
      lpvMessage = argv[1];
 
// Try to open a named pipe; wait for it, if necessary. 
 
   while (1) 
   { 
      hPipe = CreateFile( 
         lpszPipename,   // pipe name 
         GENERIC_READ |  // read and write access 
         GENERIC_WRITE, 
         0,              // no sharing 
         NULL,           // default security attributes
         OPEN_EXISTING,  // opens existing pipe 
         0,              // default attributes 
         NULL);          // no template file 
 
   // Break if the pipe handle is valid. 
 
      if (hPipe != INVALID_HANDLE_VALUE) 
         break; 
 
      // Exit if an error other than ERROR_PIPE_BUSY occurs. 
 
      if (GetLastError() != ERROR_PIPE_BUSY) 
      {
         _tprintf( TEXT("Could not open pipe. GLE=%d\n"), GetLastError() ); 
         return -1;
      }
 
      // All pipe instances are busy, so wait for 20 seconds. 
 
      if ( ! WaitNamedPipe(lpszPipename, 20000)) 
      { 
         printf("Could not open pipe: 20 second wait timed out."); 
         return -1;
      } 
   } 
 
// The pipe connected; change to message-read mode. 
 
   dwMode = PIPE_READMODE_MESSAGE; 
   fSuccess = SetNamedPipeHandleState( 
      hPipe,    // pipe handle 
      &dwMode,  // new pipe mode 
      NULL,     // don't set maximum bytes 
      NULL);    // don't set maximum time 
   if ( ! fSuccess) 
   {
      _tprintf( TEXT("SetNamedPipeHandleState failed. GLE=%d\n"), GetLastError() ); 
      return -1;
   }
 
// Send a message to the pipe server. 
 
   cbToWrite = (lstrlen(lpvMessage)+1)*sizeof(TCHAR);
   _tprintf( TEXT("Sending %d byte message: \"%s\"\n"), cbToWrite, lpvMessage); 

   fSuccess = WriteFile( 
      hPipe,                  // pipe handle 
      lpvMessage,             // message 
      cbToWrite,              // message length 
      &cbWritten,             // bytes written 
      NULL);                  // not overlapped 

   if ( ! fSuccess) 
   {
      _tprintf( TEXT("WriteFile to pipe failed. GLE=%d\n"), GetLastError() ); 
      return -1;
   }

   printf("\nMessage sent to server, receiving reply as follows:\n");
 
   do 
   { 
   // Read from the pipe. 
 
      fSuccess = ReadFile( 
         hPipe,    // pipe handle 
         chBuf,    // buffer to receive reply 
         BUFSIZE*sizeof(TCHAR),  // size of buffer 
         &cbRead,  // number of bytes read 
         NULL);    // not overlapped 
 
      if ( ! fSuccess && GetLastError() != ERROR_MORE_DATA )
         break; 
 
      _tprintf( TEXT("\"%s\"\n"), chBuf ); 
   } while ( ! fSuccess);  // repeat loop if ERROR_MORE_DATA 

   if ( ! fSuccess)
   {
      _tprintf( TEXT("ReadFile from pipe failed. GLE=%d\n"), GetLastError() );
      return -1;
   }

   printf("\n<End of message, press ENTER to terminate connection and exit>");
   _getch();
 
   CloseHandle(hPipe); 
 
   return 0; 
}

Связанные темы

Сервер многопоточного канала

Сервер именованного канала с использованием перекрывающихся операций ввода-вывода

Сервер именованного канала, использующий подпрограммы завершения