AddPort

Declare Function Api_AddPort& Lib "winspool.drv" Alias "AddPortA" (ByVal pName$, ByVal hwnd&, ByVal pMonitorName$)

Declare Function AddPort Lib "winspool.drv" Alias "AddPortA" (ByVal pName As String, ByVal hwnd As Long, ByVal pMonitorName As String) As Long

サポートされるポートのリストにポートの名前を追加する。AddPort 関数はプリントモニタによってエクスポートされる。

パラメータ

pName
    ポートの接続先サーバーの名前を表す 0 で終わる文字列へのポインタを指定する。このパラメータを NULL にするとローカルポートになる。
hWnd
    AddPort ダイアログボックスの親ウィンドウを識別するハンドルを指定する。
pMonitorName
    ポートに関連付けられたモニタを表す NULL で終わる文字列へのポインタを指定する。

戻り値
    関数が成功すると、0 以外の値が返る。
    関数が失敗すると、0 が返る。拡張エラー情報を取得するには、 関数を使う。

解説
    AddPort 関数はネットワークを参照して既存のポートを調べ、ユーザーのためのダイアログボックスを表示する。AddPort 関数は、

    EnumPorts 関数を使ってユーザーが入力したポート名を確認し、重複した名前が存在しないようにするはずである。
    AddPort 関数を使うには、ポートの接続先サーバーへの SERVER_ACCESS_ADMINISTER アクセス権が必要である。