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.

Sinalizador	Quando recebido	Onde recebido
COPYFILE_EVENT_ADD_PRINTER_CONNECTION	Depois que um aplicativo cliente tiver chamado AddPrinterConnection.	Cópia do cliente de SpoolerCopyFileEvent. O contexto de chamada é o aplicativo cliente.
COPYFILE_EVENT_DELETE_PRINTER	Depois que uma chamada para DeletePrinter for feita.	Cópia do cliente de 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 de SpoolerCopyFileEvent. O contexto de chamada é o aplicativo cliente.
COPYFILE_EVENT_FILES_CHANGED	Depois que o cliente tiver baixado os arquivos especificados na subchave pszKey da chave do Registro CopyFiles da impressora.	Cópia do cliente de SpoolerCopyFileEvent. O contexto de chamada é o spooler do cliente.
COPYFILE_EVENT_SET_PRINTER_DATAEX	Depois que uma chamada para SetPrinterDataEx tiver sido processada no servidor.	Cópia do servidor de SpoolerCopyFileEvent. O contexto de chamada é o aplicativo cliente, por representação.

Retornar valor

Se a função encontrar erros, a função deverá retornar FALSE. Caso contrário, ele deverá retornar TRUE.

Comentários

Todas as DLLs de 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 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
Plataforma de Destino	Universal
Cabeçalho	winsplp.h (inclua Winsplp.h)
Biblioteca	Mscms.lib
DLL	Mscms.dll

Confira também

GenerateCopyFilePaths