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

Recupera el nombre del puerto actual para su uso con PrintDlgEx.

Sintaxis

HRESULT GetCurrentPortName(
  LPWSTR pPortName,
  UINT   *pcchSize
);

Parámetros

pPortName

Tipo: LPTSTR

Nombre del puerto actual.

pcchSize

Tipo: UINT*

En la entrada, la variable especifica el tamaño, en caracteres, del búfer al que apunta el parámetro lpPortName . En la salida, la variable contiene el número de bytes (ANSI) o caracteres (Unicode), incluido el carácter nulo de terminación, escrito en el búfer.

Si el tamaño es cero en la entrada, la función devuelve el tamaño de búfer necesario (en bytes o caracteres) en pcchSize y no usa el búfer lpPortName .

Valor devuelto

Tipo: HRESULT

Si el método se realiza correctamente, el valor devuelto se S_OK. Si no hay ningún puerto actual, el valor devuelto es S_OK, el valor devuelto en pcchSize es cero y el búfer lpPortName no cambia.

Si se produce un error, el valor devuelto es un código de error COM. Para más información, consulte Control de errores.

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows 2000 Professional [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows 2000 Server [solo aplicaciones de escritorio]
Plataforma de destino	Windows
Encabezado	commdlg.h (incluye Windows.h)
Archivo DLL	Comdlg32.dll

Consulte también

Biblioteca de cuadros de diálogo comunes

Conceptual

IPrintDialogServices

PrintDlgEx

Referencia