Shell. FindPrinter, méthode

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

Syntaxe

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

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

Paramètres

sName [ dans, facultatif]

Type : BSTR

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

sLocation [ dans, facultatif]

Type : BSTR

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

sModel [ dans, facultatif]

Type : BSTR

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

Notes

Si vous assignez des chaînes à un ou plusieurs des paramètres facultatifs, ils 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 est affichée. L’utilisateur peut accepter ou remplacer ces valeurs. Si aucune valeur n’est assignée à un paramètre, la zone d’édition associée est vide et l’utilisateur doit entrer une valeur.

Cette méthode n’est pas disponible actuellement 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 est indiquée 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 Professional, Windows XP [ desktop apps uniquement]
Serveur minimal pris en charge
Windows Serveur 2003 [ applications de bureau uniquement]
En-tête
Shldisp. h
MIDL
Shldisp. idl
DLL
Shell32.dll (version 5,0 ou ultérieure)