Função PTCloseProvider (prntvpt.h)

Fecha um identificador do provedor de tíquetes de impressão.

Sintaxe

HRESULT PTCloseProvider(
  [in] HPTPROVIDER hProvider
);

Parâmetros

[in] hProvider

Um identificador para o provedor. Esse identificador é retornado pela função PTOpenProvider ou PTOpenProviderEx .

Retornar valor

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

Se hProvider foi aberto em um thread diferente, o HRESULT será E_INVALIDARG.

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

Comentários

Nota 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 implementação do driver de impressora— fatores 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 parâmetro hProvider deve ser um identificador aberto no mesmo thread que o thread no qual ele é usado para essa função.

Um identificador não pode ser usado depois de fechado.

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Windows XP [somente aplicativos da área de trabalho]
Servidor mínimo com suporte	Windows Server 2003 [somente aplicativos da área de trabalho]
Plataforma de Destino	Windows
Cabeçalho	prntvpt.h
Biblioteca	Prntvpt.lib
DLL	Prntvpt.dll

Confira também

Esquema de Impressão

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

Impressão