Compartilhar via


Instalando arquivos específicos da fila

No momento da instalação da impressora, um aplicativo de instalação fornecido pelo fornecedor pode especificar um conjunto de arquivos, de qualquer tipo, a serem associados a uma fila de impressão específica. Os arquivos são baixados para cada cliente que se conecta ao servidor de impressão. O aplicativo de instalação especifica os arquivos colocando valores no registro, conforme ilustrado na tabela a seguir.

Nome do valor Tipo de valor Valor
Diretório REG_SZ Caminho do diretório para os arquivos especificados por Arquivos. Usado como o caminho de origem no servidor e o caminho de destino no cliente. Esse caminho é relativo à variável de ambiente PRINT$.
Arquivos REG_MULTI_SZ Nomes de arquivo dos arquivos a serem copiados para um cliente quando o cliente se conectar ao servidor de impressão. Os arquivos podem ser DLLs, arquivos de dados ou qualquer outro tipo de arquivo.
Módulo REG_SZ Nome de arquivo de uma DLL de Ponto e Impressão opcional.

O aplicativo deve criar esses valores chamando a função SetPrinterDataEx do spooler de impressão. A chave do Registro especificada com essa chamada deve ser formatada como:

CopyFiles\ComponentName

em que ComponentName é o nome do componente de software ao qual os arquivos estão associados. Por exemplo, os arquivos associados ao ICM (Gerenciamento de Cores de Imagem) da Microsoft são especificados na chave CopyFiles\ICM . Especifique o nome da chave do Registro como um argumento para a função SetPrinterDataEx e a função cria a chave como uma subchave da chave da fila de impressão no servidor de impressão.

Exemplo de instalação

Por exemplo, suponha que uma impressora HP Color LaserJet esteja instalada em um servidor de impressão e receba o nome da fila de impressão "HpColor". Suponha também que o Microsoft ICM exija que os dois arquivos a seguir sejam associados à fila de impressão:

  • Um perfil de cor chamado hpclrlsr.icm, localizado em PRINT$\Color no servidor.

  • Uma DLL chamada Mscms.dll, localizada em PRINT$\Color no servidor.

Um aplicativo de instalação chamaria a função de API do ICM AssociateColorProfileWithDevice, que, por sua vez, chama SetPrinterDataEx para criar as seguintes entradas de registro de servidor:

CopyFiles\ICM\Directory: Color
CopyFiles\ICM\Files: hpclrsr.icm
CopyFiles\ICM\Module: mscms.dll

O módulo Mscms.dll é uma DLL de Ponto e Impressão que exporta as funções GenerateCopyFilePaths e SpoolerCopyFileEvent .