Как правильно работать с API функциями Win32 Spooler

Данный набор API функций Win32 спулера занимается в основном заполнением массива структур. Однако, структуры обычно включают в себя указатели на строки либо на другие данные. Эти посторонние данные также должны быть сохранены в возвращаемой памяти, соответственно они добавляются в конец массива. Поэтому, простого объявления массива таких структур в стеке будет недостаточно, чтобы хранить всю информацию, которую возвращают данные API функции.

Итак, речь идёт о функциях: EnumForms(), EnumJobs(), EnumMonitors(), EnumPorts(), EnumPrinterDrivers(), EnumPrinters(), и EnumPrintProcessors(). Кстати, функции GetJob(), GetPrinter(), и DocumentProperties() требуют идентичной обработки. Каждую функцию необходимо вызывать дважды. Первый вызов предназначен для определения необходимого размера буфера, а последующий вызов необходим для передачи указателя на динамически распределённый буфер достаточного размера. Код, представленный ниже, является консольным приложением, и демонстрирует использование функции EnumJobs():

   BOOL ListJobsForPrinter( LPTSTR szPrinterName )
   {

   HANDLE         hPrinter;
   DWORD          dwNeeded, dwReturned, i;
   JOB_INFO_1     *pJobInfo;

   // Нам понадобится дескриптор принтера, поэтому откроем его
   if( ! OpenPrinter( szPrinterName, &hPrinter, NULL ) )
     return FALSE;

   // Сперва вызовем EnumJobs() чтобы определить, сколько нам потребуется
   // памяти
   if( ! EnumJobs( hPrinter, 0, 0xFFFFFFFF, 1, NULL, 0, &dwNeeded,
                   &dwReturned ) )
   {
     // В любом случае надо обработать ошибку нехватки памяти
     if( GetLastError() != ERROR_INSUFFICIENT_BUFFER )
     {
       ClosePrinter( hPrinter );
       return FALSE;
     }
   }
   // Распределяем достаточное количество памяти для структуры JOB_INFO_1
   // плюс дополнительные данные - dwNeeded из предыдущего вызова
   // говорит нам, какой объём необходим
   if( (pJobInfo = (JOB_INFO_1 *)malloc( dwNeeded )) == NULL )
   {
     ClosePrinter( hPrinter );
     return FALSE;
   }
   // Вызываем EnumJobs() снова, заполняя тем самым структуры
   if( ! EnumJobs( hPrinter, 0, 0xFFFFFFFF, 1, (LPBYTE)pJobInfo,
                   dwNeeded, &dwNeeded, &dwReturned ) )
   {
     ClosePrinter( hPrinter );
     free( pJobInfo );
     return FALSE;
   }
   // Больше дескриптор принтера нам не нужен, поэтому закрываем его
   ClosePrinter( hPrinter );

   // dwReturned говорит нам, сколько текущих заданий
   // Просто отображаем количество найденных заданий
   printf( "%d jobs\n", dwReturned );
   // Проще сделать это в цикле и пройтись по каждому заданию
   for(i=0;i<dwReturned;i++)
   {
     // pJobInfo[i] это структура JOB_INFO_1 для данного задания
     printf( "[%d] [%s]\n", pJobInfo[i].JobId, pJobInfo[i].pDocument );
   }

   // Очищаем
   free( pJobInfo );
   return TRUE;
 }