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.
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 |
|
| Biblioteca |
|
| DLL |
|
| Nomes Unicode e ANSI |
UploadPrinterDriverPackageW (Unicode) e UploadPrinterDriverPackageA (ANSI) |