次の方法で共有

ConfigurePortUI 関数 (winsplp.h)

  • [アーティクル]

ポート モニター UI DLL の ConfigurePortUI 関数は、ユーザーからポート構成情報を取得し、ポート モニター サーバー DLL に送信します。

構文

BOOL WINAPI pfnConfigurePortUI(
  _In_opt_ PCWSTR pszServer,
  _In_     HWND   hWnd,
  _In_     PCWSTR pszPortName
);

パラメーター

[in, optional] pszServer

サーバー名を表す文字列への呼び出し元指定のポインター。プリンターがローカルの場合は NULL 。 (ポート モニターはこのパラメーターを無視できます)。

[in] hWnd

ダイアログ ボックスの親として使用するウィンドウの呼び出し元指定のハンドル。 NULL 場合、ダイアログ ボックスは表示されません。

[in] pszPortName

構成するポートの名前を表す文字列への呼び出し元指定のポインター。

戻り値

操作が成功した場合、関数は TRUE 返す必要があります。 それ以外の場合は、FALSE 返す必要があります。 操作がサポートされていない場合、またはユーザーによって取り消された場合 ([キャンセル] を選択するか、構成パラメーターを変更せずに [OK] を選択した場合)、関数は SetLastError(ERROR_CANCELLED) を呼び出し、FALSE 返す必要があります。

備考

ポート モニター UI DLL は、ConfigurePortUI 関数を定義し、MONITORUI 構造体に関数のアドレスを含めるために必要です。

クライアントのスプーラーは、ConfigurePort 関数内から ConfigurePortUI 呼び出します (Microsoft Windows SDK ドキュメントで説明)。 ConfigurePortUI が受け取る引数は、ConfigurePortで受け取る引数です。

この関数は、次の操作を実行する必要があります。

  1. OpenPrinter を呼び出し、プリンター名を次の形式で指定します。
    \\ ServerName\,XcvPortPortName

    ここで、ServerName と PortName は、ConfigurePortUI 関数の引数 受け取るサーバー名とポート名です。

    OpenPrinter の呼び出しには、Windows SDK ドキュメントで説明されているPRINTER_DEFAULTS構造が必要です。 構造体の DesiredAccess メンバーを SERVER_ACCESS_ADMINISTER に設定する必要があります。 その pDatatype および pDevMode メンバー NULL をできます。

    この呼び出しにより、印刷モニター サーバー DLL の XcvOpenPort 関数が呼び出されます。

  2. ダイアログ ボックスを表示して、ユーザーからポート構成パラメーターを取得します。
  3. XcvData 1 回以上呼び出し、カスタマイズされたデータ名文字列を指定して、各構成パラメーターをサーバー DLL に送信します。 XcvData 呼び出し ごとに、サーバーの XcvDataPort 関数が呼び出されます。
  4. OpenPrinter から受信したハンドルを指定して ClosePrinter を呼び出します。 これにより、サーバー DLL の XcvClosePort 関数が呼び出されます。

必要条件

要件 価値
ターゲット プラットフォーム の デスクトップ
ヘッダー winsplp.h (Winsplp.h を含む)
ライブラリ NtosKrnl.exe

関連項目

XcvOpenPort の

XcvClosePort を する

XcvDataPort を する

XcvData を する