ITaskService::Connect-Methode (taskschd.h)

  • Artikel

Stellt eine Verbindung mit einem Remotecomputer her und ordnet alle nachfolgenden Aufrufe auf dieser Schnittstelle einer Remotesitzung zu. Wenn der ServerName-Parameter leer ist, wird diese Methode auf dem lokalen Computer ausgeführt. Wenn der Benutzer nicht angegeben ist, wird das aktuelle Token verwendet.

Syntax

HRESULT Connect(
  [in, optional] VARIANT serverName,
  [in, optional] VARIANT user,
  [in, optional] VARIANT domain,
  [in, optional] VARIANT password
);

Parameter

[in, optional] serverName

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.

[in, optional] user

Der Benutzername, der während der Verbindung mit dem Computer verwendet wird. Wenn der Benutzer nicht angegeben ist, wird das aktuelle Token verwendet.

[in, optional] domain

Die Domäne des Benutzers, der im user-Parameter angegeben ist.

[in, optional] password

Das Kennwort, das zum Herstellen einer Verbindung mit dem Computer verwendet wird. Wenn der Benutzername und das Kennwort nicht angegeben sind, wird das aktuelle Token verwendet.

Rückgabewert

Diese Methode kann einen dieser Werte zurückgeben.

Rückgabecode/-wert BESCHREIBUNG
S_OK
0
 Der Vorgang wurde erfolgreich abgeschlossen.
E_ACCESS_DENIED
0x80070005
 Der Zugriff zum Herstellen einer Verbindung mit dem Aufgabenplanungsdienst wird verweigert.
SCHED_E_SERVICE_NOT_RUNNING
0x80041315
 Der Aufgabenplanungsdienst wird nicht ausgeführt.
E_OUTOFMEMORY
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.
ERROR_BAD_NETPATH
53
 Dieser Fehler wird in den folgenden Situationen zurückgegeben:
  • Der im ServerName-Parameter 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 Firewallausnahme für die Verwaltung von Remoteaufgaben nicht aktiviert und die Firewallausnahme Datei- und Druckerfreigabe aktiviert ist, oder der Remoteregistrierungsdienst wird nicht ausgeführt.
ERROR_NOT_SUPPORTED
50
 Der Benutzer-, Kennwort- oder Domänenparameter kann nicht angegeben werden, wenn eine Verbindung mit einem Windows XP- oder Windows Server 2003-Remotecomputer von einem Windows Vista-Computer hergestellt wird.

Hinweise

Die ITaskService::Connect-Methode sollte aufgerufen werden, bevor eine der anderen ITaskService-Methoden aufgerufen wird.

Wenn Sie von einem Windows Vista aus eine Verbindung mit einem Windows Vista-Remotecomputer herstellen möchten, müssen Sie die Firewallausnahme Für die Verwaltung geplanter Remoteaufgaben auf dem Remotecomputer zulassen. Um diese Ausnahme zuzulassen, klicken Sie auf Start, Systemsteuerung, Sicherheit, 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 Firewallausnahme 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.

HinweisDer ITaskService::Connect gibt möglicherweise einen Fehler SCHED_E_INVALIDVALUE beim Lesen der Aufgabendefinition zurück, wenn das Schema der Remoteaufgabe vom aktuellen Computer nicht unterstützt wird. Überprüfen Sie die ITaskService::HighestVersion-Eigenschaft , um die höchste Schemaversion zu überprüfen, die vom aktuellen Computer unterstützt wird.
 

Anforderungen

   
Unterstützte Mindestversion (Client) Windows Vista [nur Desktop-Apps]
Unterstützte Mindestversion (Server) Windows Server 2008 [nur Desktop-Apps]
Zielplattform Windows
Kopfzeile taskschd.h
Bibliothek Taskschd.lib
DLL Taskschd.dll

Weitere Informationen

ITaskService

ITaskService::HighestVersion