Função InstallPrinterDriverFromPackage
Instala um driver de impressora de um pacote de driver que está no repositório de driver do servidor de impressão.
Sintaxe
HRESULT InstallPrinterDriverFromPackage(
_In_ LPCTSTR pszServer,
_In_ LPCTSTR pszInfPath,
_In_ LPCTSTR pszDriverName,
_In_ LPCTSTR pszEnvironment,
_In_ DWORD dwFlags
);
Parâmetros
-
pszServer [in]
-
Um ponteiro para uma cadeia de caracteres constante terminada em nulo que especifica o nome do servidor de impressão. NULL significa o computador local.
-
pszInfPath [in]
-
Um ponteiro para uma cadeia de caracteres constante terminada em nulo que especifica o caminho do repositório de driver para o arquivo .inf do driver de impressão. NULL significa que o driver está em um arquivo inf fornecido com o Windows.
-
pszDriverName [in]
-
Um ponteiro para uma cadeia de caracteres constante terminada em nulo que especifica o nome do driver.
-
pszEnvironment [in]
-
Um ponteiro para uma cadeia de caracteres constante terminada em nulo que especifica a arquitetura do processador (por exemplo, Windows NT x86). Isso pode ser NULL.
-
dwFlags [in]
-
Isso só pode ser 0 ou IPDFP_COPY_ALL_FILES. Um valor 0 significa que o driver da impressora deve ser adicionado e todos os arquivos no diretório do driver de impressora mais recentes do que os arquivos correspondentes atualmente em uso devem ser copiados. Um valor de IPDFP_COPY_ALL_FILES significa que o driver da impressora e todos os arquivos no diretório do driver da impressora devem ser adicionados. Os carimbos de data/hora do arquivo são ignorados quando dwFlags tem um valor de IPDFP_COPY_ALL_FILES.
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 de driver de impressora que são difíceis de prever ao escrever 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.
O repositório de driver normalmente é %windir%\inf ou %windir%\System32\DriverStore\FileRepository.
InstallPrinterDriverFromPackage também instala outros arquivos no pacote, como perfis de cores e processadores de impressão.
Os usuários devem ter direitos de administração de impressora para instalar em um computador remoto ou no computador local quando o usuário estiver conectado com os Serviços de Terminal.
Somente pacotes assinados podem ser instalados em um computador remoto.
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 |
|
| Nomes Unicode e ANSI |
InstallPrinterDriverFromPackageW (Unicode) e InstallPrinterDriverFromPackageA (ANSI) |