TaskService.Connect-Methode
Stellen Sie für Skripterstellung eine Verbindung mit einem Remotecomputer her und ordnet alle nachfolgenden Aufrufe dieser Schnittstelle einer Remotesitzung zu. Wenn der serverName-Parameter leer ist, wird diese Methode auf dem lokalen Computer ausgeführt. Wenn die userId nicht angegeben wird, wird das aktuelle Token verwendet.
Syntax
TaskService.Connect( _
[ ByVal serverName ], _
[ ByVal user ], _
[ ByVal domain ], _
[ ByVal password ] _
)
Parameter
-
serverName [in, optional]
-
Der Name des Computers, mit dem Sie eine Verbindung herstellen möchten. Wenn der serverName-Parameter leer ist, wird diese Methode auf dem lokalen Computer ausgeführt.
-
Benutzer [in, optional]
-
Der Benutzername, der während der Verbindung mit dem Computer verwendet wird. Wenn der Benutzer nicht angegeben ist, wird das aktuelle Token verwendet.
-
Domäne [in, optional]
-
Die Domäne des Benutzers, der im Benutzerparameter angegeben ist.
-
Kennwort [in, optional]
-
Das Kennwort, das zum Herstellen einer Verbindung mit dem Computer verwendet wird. Wenn der Benutzername und das Kennwort nicht angegeben werden, wird das aktuelle Token verwendet.
Rückgabewert
Diese Methode gibt keinen Wert zurück.
Bemerkungen
Die TaskService.Connect-Methode sollte aufgerufen werden, bevor eine der anderen TaskService-Methoden aufgerufen wird.
Wenn bei der Connect-Methode ein Fehler auftritt, können Sie den Fehlerbezeichner erfassen, um die Bedeutung des Fehlers zu ermitteln. In der folgenden Tabelle sind die Fehlerbezeichner und ihre Beschreibungen aufgeführt.
| Fehlerbezeichner | BESCHREIBUNG |
|---|---|
| 0x80070005 | Der Zugriff wird verweigert, um eine Verbindung mit dem Aufgabenplanerdienst herzustellen. |
| 0x80041315 | Der Taskplanerdienst wird nicht ausgeführt. |
| 0x8007000e | Die Anwendung verfügt nicht über genügend Arbeitsspeicher, um den Vorgang abzuschließen, oder der Benutzer, das Kennwort oder die Domäne verfügt über mindestens einen NULL- und einen Ungleich-NULL-Wert. |
| 53 | Dieser Fehler wird in den folgenden Situationen zurückgegeben:
|
| 50 | Die Benutzer-, Kennwort- oder Domänenparameter können nicht angegeben werden, wenn eine Verbindung mit einem Windows XP- oder Windows Server 2003-Remotecomputer von einem Windows Vista-Computer hergestellt wird. |
Wenn Sie eine Verbindung mit einem Windows Vista-Remotecomputer herstellen möchten, müssen Sie die Firewall-Ausnahme für die Verwaltung geplanter Remoteaufgaben auf dem Remotecomputer zulassen. Um diese Ausnahme zuzulassen, klicken Sie auf Start, Systemsteuerung, Sicherheit, Ein Programm über die Windows-Firewall zulassen, und aktivieren Sie dann das Kontrollkästchen Verwaltung geplanter Remoteaufgaben. Klicken Sie dann im Dialogfeld Windows-Firewalleinstellungen auf die Schaltfläche OK.
Wenn Sie von einem Windows Vista-Computer aus eine Verbindung mit einem Windows XP- oder Windows Server 2003-Remotecomputer herstellen, müssen Sie die Ausnahme für die Datei- und Druckerfreigabe auf dem Remotecomputer zulassen. Um diese Ausnahme zuzulassen, klicken Sie auf Start, Systemsteuerung, doppelklicken Sie auf Windows-Firewall, wählen Sie die Registerkarte Ausnahmen aus, und wählen Sie dann die Firewallausnahme Datei- und Druckerfreigabe aus. Klicken Sie dann im Dialogfeld Windows-Firewall auf die Schaltfläche OK. Der Remoteregistrierungsdienst muss auch auf dem Remotecomputer ausgeführt werden.
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) |
Windows Vista [nur Desktop-Apps] |
| Unterstützte Mindestversion (Server) |
Windows Server 2008 [nur Desktop-Apps] |
| Typbibliothek |
|
| DLL |
|