Funktionreferenz


_WinNet_UseConnection

Beschreibung anzeigen in

Verbindet ein lokales Gerät mit einer Netzwerkressource

#include <WinNet.au3>
_WinNet_UseConnection ( $hWnd, $sLocalName, $sRemoteName [, $sUserName = 0 [, $sPassword = 0 [, $iType = 1 [, $iOptions = 1]]]] )

Parameter

$hWnd Handle zu einem Fenster, das der Anbieter der Netzwerkressource eigenständig für Dialoge verwenden kann.
Dieser Parameter wird verwendet, wenn Bit 2 (Interaktiv) bei $iOptions gewählt wird.
Dieser Parameter kann den Wert 0 haben.
$sLocalName Name eines lokalen Gerätes wie z.B. "F:" oder "LPT1".
Bei diesem String ist auf Groß-/Kleinschreibung zu achten.
Wenn dieser Parameter 0 ist, wird eine Verbindung zu der Netzwerkressource ohne Umleitung auf das lokale Gerät hergestellt.
$sRemoteName Name der Netzwerkressource, zu der verbunden werden soll.
$sUsername [optional] Username zum Herstellen der Verbindung.
Wenn dieser Parameter 0 ist verwendet die Funktion den Standard Usernamen.
$sPassword [optional] Passwort zum Herstellen der Verbindung.
Wenn dieser Parameter 0 ist verwendet die Funktion das Standard Passwort.
Wenn der String leer ist, wird kein Passwort verwendet.
$iType [optional] Gibt den Typ der Netzwerkressource an, zu der verbunden werden soll:
    0 - Jede (nur wenn $sLocalName leer ist)
    1 - Laufwerk
    2 - Drucker
$iOptions [optional] Verbindungsoptionen. Kann einer der folgenden Werte sein:
    1 - Die Verbindung zur Netzwerkressource soll gespeichert werden
    2 - Das Betriebssystem kann Abfragen zur User-Authentifizierung machen (Abfragefenster)
    4 - Das System verwendet Standard Usernamen oder Passwörter nicht ohne dem Benutzer die Möglichkeit zu geben,
        diese alternativ manuell einzugeben. Dieses Flag wird ignoriert, wenn nicht auch Bit 2 (Interaktiv) gesetzt ist.
    8 - Erzwingt das Umleiten eines lokalen Gerätes, wenn die Verbindung hergestellt wird
    16 - Das Betriebssystem verwendet die Kommandozeile zur Eingabe der Authentifizierung verwendet anstatt einer GUI.
        Dieses Flag wird ignoriert, wenn nicht auch Bit 2 (Interaktiv) gesetzt ist.
    32 - Wenn dieses Bit gesetzt ist und das Betriebssystem meldet mit einer Eingabeaufforderung, dass eine Authentifizierung
        notwendig ist, werden die Eingabedaten vom Credential Manager gespeichert. Wenn der Credential Manager deaktiviert ist für diese Session,
        oder das speichern nicht vom Netzwerk Provider unterstützt ist, wird dieses Flag ignoriert. Dieses Flag wird ignoriert,
        wenn nicht auch Bit 5 (Eingabeaufforderung anstatt GUI) gesetzt ist.

Rückgabewert

Erfolg: Ein Array mit dem folgenden Format:
    $aInfo[0] - Wenn True, die Verbindung wurde hergestellt mit der Umleitung eines lokalen Gerätes
    $aInfo[1] - Wenn $sLocalName ein lokales Gerät angibt, ist dies der lokale Gerätename. Wenn mit $sLocalName kein Gerät angegeben wurde
        und das Netzwerk eine Umleitung auf ein lokales Gerät benötigt, oder wenn Bit 4 (erzwungene Umleitung) gesetzt ist, gibt dieser Wert
        den Namen des umgeleiteten lokalen Gerätes zurück. Ansonsten gibt dieser Wert den Namen der Remote Ressource zurück.
Fehler: Setzt das @error Flag auf ungleich null

Siehe auch

Suche nach WNetUseConnection in der MSDN Bibliothek.