Méthode IShellDispatch2.FindPrinter

Affiche la boîte de dialogue Rechercher l’imprimante .

Syntaxe

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

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

Paramètres

sName [in, facultatif]

Type : BSTR

Chaîne qui contient le nom de l’imprimante.

sLocation [in, facultatif]

Type : BSTR

Chaîne qui contient l’emplacement de l’imprimante.

sModel [in, facultatif]

Type : BSTR

Chaîne qui contient le modèle d’imprimante.

Notes

Cette méthode est implémentée et accessible via la méthode Shell.FindPrinter .

Si vous affectez des chaînes à un ou plusieurs des paramètres facultatifs, elles s’affichent en tant que valeurs par défaut dans le contrôle d’édition associé lorsque la boîte de dialogue Rechercher l’imprimante s’affiche. L’utilisateur peut accepter ou remplacer ces valeurs. Si aucune valeur n’est affectée à un paramètre, la zone d’édition associée est vide et l’utilisateur doit entrer une valeur.

Cette méthode n’est actuellement pas disponible dans Microsoft Visual Basic.

Exemples

Les exemples suivants illustrent l’utilisation de FindPrinter pour afficher la boîte de dialogue Rechercher une imprimante pour une application particulière. L’utilisation s’affiche pour JScript, VBScript et 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>

Spécifications

Condition requise	Valeur
Client minimal pris en charge	Windows 2000 Professionnel, Windows XP [applications de bureau uniquement]
Serveur minimal pris en charge	Windows Server 2003 [applications de bureau uniquement]
En-tête	Shldisp.h
IDL	Shldisp.idl
DLL	Shell32.dll (version 5.0 ou ultérieure)