TaskService.Connect-Methode

Artikel
06/13/2023

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: Der im Parameter serverName angegebene Computername ist nicht vorhanden. Wenn Sie versuchen, eine Verbindung mit einem Windows Server 2003- oder Windows XP-Computer herzustellen, und auf dem Remotecomputer die Firewall-Ausnahme datei- und druckerfreigabe nicht aktiviert ist oder der Remoteregistrierungsdienst nicht ausgeführt wird. Wenn Sie versuchen, eine Verbindung mit einem Windows Vista-Computer herzustellen, und auf dem Remotecomputer die Firewall-Ausnahme für die Verwaltung geplanter Remoteaufgaben nicht aktiviert ist und die Firewall-Ausnahme Datei- und Druckerfreigabe aktiviert ist, oder der Remoteregistrierungsdienst wird nicht ausgeführt.
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	Taskschd.tlb
DLL	Taskschd.dll

Share via