Compartilhar via


Método IPrintDialogServices::GetCurrentPrinterName (commdlg.h)

Recupera o nome da impressora selecionada no momento, para uso com PrintDlgEx.

Sintaxe

HRESULT GetCurrentPrinterName(
  LPWSTR pPrinterName,
  UINT   *pcchSize
);

Parâmetros

pPrinterName

Tipo: LPTSTR

O nome da impressora selecionada no momento.

pcchSize

Tipo: UINT*

Na entrada, a variável especifica o tamanho, em caracteres, do buffer apontado pelo parâmetro lpPrinterName . Na saída, a variável contém o número de bytes (ANSI) ou caracteres (Unicode), incluindo o caractere nulo de terminação, gravado no buffer.

Se o tamanho for zero na entrada, a função retornará o tamanho do buffer necessário (em bytes ou caracteres) em pcchSize e não usará o buffer lpPrinterName .

Valor retornado

Tipo: HRESULT

Se o método for bem-sucedido, o valor retornado será S_OK. Se nenhuma impressora estiver selecionada no momento, o valor retornado será S_OK, o valor retornado em pcchSize será zero e o buffer lpPrinterName ficará inalterado.

Se ocorrer um erro, o valor retornado será um código de erro COM. Para saber mais, confira o Tratamento de erros.

Requisitos

   
Cliente mínimo com suporte Windows 2000 Professional [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Windows 2000 Server [somente aplicativos da área de trabalho]
Plataforma de Destino Windows
Cabeçalho commdlg.h (inclua Windows.h)
DLL Comdlg32.dll

Confira também

Biblioteca de caixas de diálogo comuns

Conceitual

IPrintDialogServices

Printdlgex

Referência