IPrintDialogServices::GetCurrentPortName

[Esta é a documentação preliminar e estão sujeitos a alterações.]

Um aplicativo usando a função PrintDlgEx pode chamar o método GetCurrentPortName para recuperar o nome da porta atual.

(HRESULT GetCurrentPortName LPTSTRlpPortName,UINT* pcchSize);
 

Parâmetros

lpPortName

Ponteiro para uma reserva que recebe o nome de terminação nula da porta atual.

pcchSize

Ponteiro para uma variável UINT . Na entrada, a variável especifica o tamanho, em bytes (versão ANSI) ou 16-bit caracteres (versão Unicode), da reserva apontado pelo lpPortName parâmetro. Na saída, a variável contém o número de bytes ou caracteres, incluindo o caractere nulo de terminação, escrito para o buffer.

Se o tamanho é zero na entrada, a função retorna o exigido tamanho do buffer (em caracteres ou bytes) em pcchSize e não usa o buffer de lpPortName.

Retornar valores

Se o método for bem-sucedido, o valor de retorno é S_OK. Se não houver nenhuma porta atual, o valor de retorno é S_OK, o valor retornado em pcchSize é zero e o buffer de lpPortName é alterado.

Se um erro ocorrer, o valor de retorno é um código de erro COM. Para obter mais informações, consulte A manipulação de erro.

QuickInfo

nbsp; Windows &NT: requer versão 5.0 ou posterior.
Windows:Sem suporte.
Windows CE:Sem suporte.
Cabeçalho:Declarado em commdlg.h.

Ver também

Visão geral de biblioteca de caixa de diálogo comum, IPrintDialogServices, PrintDlgEx

Index