Metodo IPrintDialogServices::GetCurrentPortName (commdlg.h)

Recupera il nome della porta corrente da usare con PrintDlgEx.

Sintassi

HRESULT GetCurrentPortName(
  LPWSTR pPortName,
  UINT   *pcchSize
);

Parametri

pPortName

Tipo: LPTSTR

Nome della porta corrente.

pcchSize

Tipo: UINT*

In input, la variabile specifica le dimensioni, in caratteri, del buffer a cui punta il parametro lpPortName . Nell'output, la variabile contiene il numero di byte (ANSI) o caratteri (Unicode), incluso il carattere Null terminante, scritto nel buffer.

Se la dimensione è zero in input, la funzione restituisce le dimensioni del buffer necessarie (in byte o caratteri) in pcchSize e non usa il buffer lpPortName .

Valore restituito

Tipo: HRESULT

Se il metodo ha esito positivo, il valore restituito è S_OK. Se non è presente alcuna porta corrente, il valore restituito è S_OK, il valore restituito in pcchSize è zero e il buffer lpPortName è invariato.

Se si verifica un errore, il valore restituito è un codice di errore COM. Per altre informazioni, vedere Gestione degli errori.

Requisiti

Requisito	Valore
Client minimo supportato	Windows 2000 Professional [solo app desktop]
Server minimo supportato	Windows 2000 Server [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	commdlg.h (includere Windows.h)
DLL	Comdlg32.dll

Vedi anche

Libreria di finestre di dialogo comuni

Informazioni concettuali

IPrintDialogServices

PrintDlgEx

Riferimento