Método IPrintDialogServices::GetCurrentPortName (commdlg.h)
Recupera o nome da porta atual para uso com PrintDlgEx.
Sintaxe
HRESULT GetCurrentPortName(
LPWSTR pPortName,
UINT *pcchSize
);
Parâmetros
pPortName
Tipo: LPTSTR
O nome da porta atual.
pcchSize
Tipo: UINT*
Na entrada, a variável especifica o tamanho, em caracteres, do buffer apontado pelo parâmetro lpPortName . 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 lpPortName .
Retornar valor
Tipo: HRESULT
Se o método for bem-sucedido, o valor retornado será S_OK. Se não houver nenhuma porta atual, o valor retornado será S_OK, o valor retornado em pcchSize será zero e o buffer lpPortName permanecerá inalterado.
Se ocorrer um erro, o valor retornado será um código de erro COM. Para saber mais, confira o Tratamento de erros.
Requisitos
| Requisito | Valor |
|---|---|
| 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
Referência