Função CommitSpoolData
A função CommitSpoolData notifica o spooler de impressão de que uma quantidade especificada de dados foi gravada em um arquivo de spool especificado e está pronta para ser renderizada.
Sintaxe
HANDLE CommitSpoolData(
_In_ HANDLE hPrinter,
_In_ HANDLE hSpoolFile,
DWORD cbCommit
);
Parâmetros
-
hPrinter [in]
-
Um identificador para a impressora para a qual o trabalho foi enviado. Esse deve ser o mesmo identificador usado para obter hSpoolFile com GetSpoolFileHandle.
-
hSpoolFile [in]
-
Um identificador para o arquivo de spool que está sendo alterado. Na primeira chamada de CommitSpoolData, esse deve ser o mesmo identificador retornado por GetSpoolFileHandle. Chamadas subsequentes para CommitSpoolData devem passar o identificador retornado pela chamada anterior. Consulte Observações.
-
cbCommit
-
O número de bytes confirmados no spooler de impressão.
Valor retornado
Se a função for bem-sucedida, ela retornará um identificador para o arquivo de spool.
Se a função falhar, ela retornará INVALID_HANDLE_VALUE.
Comentários
Os aplicativos que enviarem um trabalho de impressão de spooler podem chamar GetSpoolFileHandle e gravar dados diretamente no identificador de arquivo de spool chamando WriteFile. Para notificar o spooler de impressão de que o arquivo contém dados que estão prontos para serem renderizados, o aplicativo deve chamar CommitSpoolData e fornecer o número de bytes disponíveis.
Se CommitSpoolData for chamado várias vezes, cada chamada deverá usar o identificador de arquivo de spool retornado pela chamada anterior. Quando não houver mais dados gravados no arquivo de spool, CloseSpoolFileHandle deverá ser chamado para o identificador de arquivo retornado pela última chamada para CommitSpoolData.
Antes de chamar CommitSpoolData, os aplicativos devem definir o ponteiro do arquivo para a posição que ele tinha antes de gravar dados no arquivo. No processo de renderização dos dados no arquivo spooler, o spooler de impressão moverá o ponteiro do arquivo de spool cbCommit bytes do valor atual do ponteiro de arquivo.
Requisitos
| Requisito | Valor |
|---|---|
| Cliente mínimo com suporte |
Windows Vista [somente aplicativos da área de trabalho] |
| Servidor mínimo com suporte |
Windows Server 2008 [somente aplicativos da área de trabalho] |
| Cabeçalho |
|
| Biblioteca |
|
| DLL |
|