Função UploadPrinterDriverPackage

Carrega um driver de impressora no repositório de driver do servidor de impressão para que ele possa ser instalado chamando InstallPrinterDriverFromPackage.

Sintaxe

HRESULT UploadPrinterDriverPackage(
  _In_    LPCTSTR pszServer,
  _In_    LPCTSTR pszInfPath,
  _In_    LPCTSTR pszEnvironment,
  _In_    DWORD   dwFlags,
  _In_    HWND    hwnd,
  _Out_   LPTSTR  pszDestInfPath,
  _Inout_ PULONG  pcchDestInfPath
);

Parâmetros

pszServer [in]

Um ponteiro para uma cadeia de caracteres terminada em nulo constante que especifica o nome do servidor de impressão. Use NULL se o servidor for o computador local.

pszInfPath [in]

Um ponteiro para uma cadeia de caracteres constante terminada em nulo que especifica o caminho de origem para o arquivo .inf do driver.

pszEnvironment [in]

Um ponteiro para uma cadeia de caracteres terminada em nulo constante que especifica a arquitetura do processador do servidor (por exemplo, Windows NT x86). Isso pode ser NULL.

dwFlags [in]

Isso pode ser qualquer um dos seguintes valores:

Valor	Significado
UPDP_SILENT_UPLOAD	A interface do usuário não será mostrada durante o upload.
UPDP_UPLOAD_ALWAYS	Os arquivos serão carregados mesmo que o pacote já esteja no repositório de driver do servidor.
UPDP_CHECK_DRIVERSTORE	O repositório de driver do servidor será verificado antes do upload para ver se o pacote já está lá. Essa configuração será ignorada se UPDP_UPLOAD_ALWAYS estiver definido.

hwnd [in]

Um identificador para a interface do usuário de cópia.

pszDestInfPath [out]

Um ponteiro para o caminho de destino, no repositório de driver, para o qual o arquivo .inf do driver foi copiado.

pcchDestInfPath [in, out]

Na entrada, especifica o tamanho, em caracteres, do buffer pszDestInfPath . Na saída, recebe o tamanho, em caracteres, da cadeia de caracteres de caminho, incluindo o caractere nulo de terminação.

Valor retornado

Se a operação for bem-sucedida, o valor retornado será S_OK, caso contrário, o HRESULT conterá um código de erro.

Para obter mais informações sobre códigos de erro COM, consulte Tratamento de erros.

Comentários

Observação

Essa é uma função de bloqueio ou síncrona e pode não retornar imediatamente. A rapidez com que essa função retorna depende de fatores de tempo de execução, como status de rede, configuração do servidor de impressão e fatores de implementação do driver de impressora que são difíceis de prever ao gravar um aplicativo. Chamar essa função de um thread que gerencia a interação com a interface do usuário pode fazer com que o aplicativo pareça não responder.

Normalmente, o repositório de driver é %windir%\inf ou %windir%\System32\DriverStore\FileRepository.

Somente um pacote de cada vez pode ser carregado. Se um pacote depender de outros, ele deverá ser carregado separadamente.

Somente pacotes de driver assinados podem ser carregados.

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	Winspool.h (inclua Windows.h)
Biblioteca	Winspool.lib
DLL	Spoolss.dll
Nomes Unicode e ANSI	UploadPrinterDriverPackageW (Unicode) e UploadPrinterDriverPackageA (ANSI)

Confira também

Impressão

Funções da API do Spooler de impressão