IShellDispatch2.FindPrinter メソッド

[プリンターの 検索 ] ダイアログ ボックスを表示します。

構文

iRetVal = IShellDispatch2.FindPrinter(
  [ sName ],
  [ sLocation ],
  [ sModel ]
)

IShellDispatch2.FindPrinter( _
  [ ByVal sName As BSTR ], _
  [ ByVal sLocation As BSTR ], _
  [ ByVal sModel As BSTR ] _
) As Integer

パラメーター

sName [in, optional]

種類: BSTR

プリンター名を含む文字列型 ( String ) の値を指定します。

sLocation [in, optional]

種類: BSTR

プリンターの場所を含む文字列型 ( String ) の値を指定します。

sModel [in, optional]

種類: BSTR

プリンター モデルを含む 文字列 。

解説

このメソッドは、 Shell.FindPrinter メソッドを使用して実装され、アクセスされます。

1 つ以上の省略可能なパラメーターに文字列を割り当てると、[ プリンターの検索 ] ダイアログ ボックスが表示されるときに、関連付けられている編集コントロールに既定値として表示されます。 ユーザーは、これらの値を受け入れるかオーバーライドできます。 パラメーターに値が割り当てられていない場合、関連付けられている編集ボックスは空になり、ユーザーは値を入力する必要があります。

現在、このメソッドは Microsoft Visual Basic では使用できません。

例

次の例は、 FindPrinter を使用して、特定のアプリケーションの [ プリンターの検索 ] ダイアログ ボックスを表示する方法を示しています。 JScript、VBScript、Visual Basic の使用法が表示されます。

Jscript：

<script language="JScript">
    function fnFindPrinterJ()
    {
        var objShell = new ActiveXObject("shell.application");
        
        objShell.FindPrinter();
    }
</script>

Vbscript：

<script language="VBScript">
    function fnFindPrinterVB()
        dim objShell
        dim bReturn

        set objShell = CreateObject("shell.application")
        objShell.FindPrinter()

        set objShell = nothing
    end function
</script>

必要条件

要件	値
サポートされている最小のクライアント	Windows 2000 Professional、Windows XP [デスクトップ アプリのみ]
サポートされている最小のサーバー	Windows Server 2003 [デスクトップ アプリのみ]
Header	Shldisp.h
IDL	Shldisp.idl
[DLL]	Shell32.dll (バージョン 5.0 以降)