IPrintDialogServices::GetCurrentPortName メソッド (commdlg.h)

PrintDlgEx で使用する現在のポートの名前を取得します。

構文

HRESULT GetCurrentPortName(
  LPWSTR pPortName,
  UINT   *pcchSize
);

pPortName

種類: LPTSTR

現在のポートの名前。

pcchSize

種類: UINT*

入力時に、変数は lpPortName パラメーターによって指されるバッファーのサイズを文字単位で指定します。出力時に、変数には、バッファーに書き込まれた終端の null 文字を含むバイト数 (ANSI) または文字 (Unicode) が含まれます。

入力時にサイズが 0 の場合、関数は pcchSize で必要なバッファーサイズ (バイトまたは文字単位) を返し、 lpPortName バッファーは使用しません。

種類: HRESULT

メソッドが成功した場合、戻り値は S_OK。現在のポートがない場合、戻り値は S_OK、 pcchSize で返される値は 0、 lpPortName バッファーは変更されません。

エラーが発生した場合、戻り値は COM エラーコードです。詳細については、「エラー処理」を参照してください。

要件	値
サポートされている最小のクライアント	Windows 2000 Professional [デスクトップアプリのみ]
サポートされている最小のサーバー	Windows 2000 Server [デスクトップアプリのみ]
対象プラットフォーム	Windows
ヘッダー	commdlg.h (Windows.h を含む)
[DLL]	Comdlg32.dll

概念

参照