DriveMapAdd
Beschreibung anzeigen in
Weist ein Netzlaufwerk zu.
DriveMapAdd ( "device", "remote share" [, flags = 0 [, "user" [, "password"]]] )
Parameter
| device | Das zuzuweisende Gerät, z.B. "O:" oder "LPT1:". Wird für diesen Parameter ein Leerstring übergeben, wird eine Verbindung hergestellt, aber ohne ein spezifisches Laufwerk zuzuweisen. Spezifiziert man "*", wird ein freier Laufwerksbuchstabe automatisch gewählt. |
| remote share | Die zu verbindende entfernte (remote) Freigabe in der Form "\Server\Freigabe". |
| flags | [optional] Eine Kombination der folgenden Werte: $DMA_DEFAULT (0) = Standard $DMA_PERSISTENT (1) = Permanente Zuweisung $DMA_AUTHENTICATION (8) = Zeigt einen Authentifizierungsdialog, falls erforderlich. Die Konstanten sind in "AutoItConstants.au3" definiert. |
| user | [optional] Der für die Verbindung zu nutzende Username. In der Form "Username" oder "Domäne\Username". |
| password | [optional] Das für die Verbindung zu nutzende Passwort. |
Rückgabewert
| Erfolg: | 1 (Siehe Bemerkungen) |
| Fehler: | 0 falls ein neues Mapping nicht erstellt werden konnte und setzt das @error Flag auf ungleich null. |
| @error: | 1 = Undefinierter / anderer Fehler. @extended enthält den Rückgabewert der Windows API. 2 = Der Zugriff auf die Remote-Freigabe wurde verweigert 3 = Das Gerät ist bereits zugewiesen 4 = Ungültiger Gerätename 5 = Ungültige Remote-Freigabe 6 = Ungültiges Passwort |
Bemerkungen
Nutzt man "*" als Geräte-Parameter, wird der gewählte Laufwerksbuchstabe an Stelle von 1 oder 0 zurückgegeben, z.B. "U:". Tritt bei der Verwendung von "*" ein Fehler auf, wird ein Leerstring "" zurückgegeben.
Falls angegeben, werden Username/Passwort zu dem Remote-Computer übermittelt, der dann die Korrektheit überprüft.
Verwandte Funktionen
Beispiel
#include <AutoItConstants.au3>
; Verbindet Laufwerk X mit \\myserver\stuff, wobei der aktuelle Benutzer benutzt wird.
DriveMapAdd("X:", "\\myserver\stuff")
; Verbindet Laufwerk X mit \\myserver2\stuff2, wobei der Benutzer "jon" aus "domainx" mit dem Passwort "tickle" benutzt wird.
DriveMapAdd("X:", "\\myserver2\stuff2", $DMA_DEFAULT, "domainx\jon", "tickle")