IPrintDialogServices::GetCurrentPortName

[To wstępne dokumentacji oraz z zastrzeżeniem zmiany.]

Aplikację przy użyciu funkcji PrintDlgEx można wywołać metodę GetCurrentPortName , aby pobrać nazwy bieżącego portu.

(HRESULT GetCurrentPortName LPTSTRlpPortName,UINT* pcchSize);
 

Parametry

lpPortName

Wskaźnik do buforu, który otrzymuje nazwę zakończony znakiem null bieżącego portu.

pcchSize

Wskaźnik zmienna UINT . Na wejściu zmienna Określa rozmiar, w bajtach (wersja ANSI) lub znaków 16-bitowych (wersja Unicode), bufor wskazywanego przez parametr lpPortName . Na wyjściu zmienna zawiera liczbę bajtów lub znaków, w tym kończącego znaku null, napisana do buforu.

Jeśli rozmiar jest równy zero na wejściu, funkcja zwraca wymaganego rozmiaru (w bajtach lub znaków) w pcchSize i nie korzysta z buforu lpPortName.

Zwraca wartości

Jeśli metoda jest pomyślne, wartość zwracana jest wartość S_OK. W przypadku nie bieżącego portu, wartość zwracana jest wartość S_OK, wartość zwracany w pcchSize jest równa zero i buforu lpPortName pozostaje niezmieniony.

Jeśli wystąpi błąd, wartość zwracany jest kod błędu COM. Aby uzyskać więcej informacji, zobacz Obsługa błędów.

Skrócone informacje

nbsp; Windows &NT: wymaga wersji 5.0 lub nowszej.
Systemu Windows:Nieobsługiwane.
Systemu Windows CE:Nieobsługiwane.
Nagłówka:Zadeklarowane w commdlg.h.

Zobacz też

Wspólny omówienie biblioteki okna dialogowego, IPrintDialogServices, PrintDlgEx

Index