Função SpoolerCopyFileEvent (winsplp.h)
A função SpoolerCopyFileEvent da DLL de Ponto e Impressão recebe notificações de eventos associados à cópia de arquivos associados à fila de impressão para um cliente de impressão, quando o cliente se conecta a um servidor de impressão.
Sintaxe
BOOL SpoolerCopyFileEvent(
[in] LPWSTR pszPrinterName,
[in] LPWSTR pszKey,
[in] DWORD dwCopyFileEvent
);
Parâmetros
[in] pszPrinterName
Ponteiro fornecido pelo chamador para uma cadeia de caracteres que representa o nome da impressora.
[in] pszKey
Ponteiro fornecido pelo chamador para uma cadeia de caracteres que representa uma subchave sob a chave do Registro CopyFiles da impressora. Essa subchave identifica o componente ao qual a DLL de Ponto e Impressão pertence.
[in] dwCopyFileEvent
Sinalizador fornecido pelo chamador que identifica o evento que está sendo relatado. Os valores de sinalizador válidos estão contidos na tabela a seguir.
| Bandeira | Quando recebido | Onde recebido |
|---|---|---|
| COPYFILE_EVENT_ADD_PRINTER_CONNECTION | Depois que um aplicativo cliente tiver chamado AddPrinterConnection. | Cópia do cliente do SpoolerCopyFileEvent. O contexto de chamada é o aplicativo cliente. |
| COPYFILE_EVENT_DELETE_PRINTER | Depois que uma chamada para DeletePrinter foi feita. | Cópia do cliente do SpoolerCopyFileEvent. O contexto de chamada é o spooler do cliente. |
| COPYFILE_EVENT_DELETE_PRINTER_CONNECTION | Depois que um aplicativo cliente tiver chamado DeletePrinterConnection. | Cópia do cliente do SpoolerCopyFileEvent. O contexto de chamada é o aplicativo cliente. |
| COPYFILE_EVENT_FILES_CHANGED | Depois que o cliente baixar os arquivos especificados no pszKey subchave da CopyFiles da impressora chave do Registro. | Cópia do cliente do SpoolerCopyFileEvent. O contexto de chamada é o spooler do cliente. |
| COPYFILE_EVENT_SET_PRINTER_DATAEX | Depois que uma chamada para SetPrinterDataEx foi processada no servidor. | Cópia do servidor do SpoolerCopyFileEvent. O contexto de chamada é o aplicativo cliente, por representação. |
Valor de retorno
Se a função encontrar erros, a função deverá retornar FALSE. Caso contrário, ele deverá retornar TRUE.
Observações
Todas as DLLs Ponto e Impressão devem exportar uma função SpoolerCopyFileEvent, que é chamada pelo spooler de impressão. Sua finalidade é permitir que uma DLL de Ponto e Impressão seja notificada sobre eventos relacionados ao download de arquivos associados à fila de impressão, de um servidor de impressão para um sistema cliente, quando um aplicativo no cliente se conecta ao servidor. Para obter uma descrição completa das etapas envolvidas na criação de uma conexão Ponto e Impressão, consulte de Ponto de Suporte e Impressão.
Uma DLL de Ponto e Impressão é executada no servidor e no cliente. A função SpoolerCopyFileEvent pode determinar onde está sendo executada lendo o conteúdo de dwCopyFileEvent, que fornece um sinalizador que indica o evento. A função deve processar o evento e retornar. Se nenhum processamento for necessário, a função deverá retornar apenas TRUE.
Se dwCopyFileEvent for COPYFILE_EVENT_ADD_PRINTER_CONNECTION ou COPYFILE_EVENT_ADD_PRINTER_CONNECTION, a cadeia de caracteres fornecida por pszPrinterName incluirá o nome do servidor.
Requisitos
| Requisito | Valor |
|---|---|
| da Plataforma de Destino | Universal |
| cabeçalho | winsplp.h (inclua Winsplp.h) |
| biblioteca | Mscms.lib |
| de DLL | Mscms.dll |