Observação
O acesso a essa página exige autorização. Você pode tentar entrar ou alterar diretórios.
O acesso a essa página exige autorização. Você pode tentar alterar os diretórios.
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) |