ITaskScheduler::SetTargetComputer-Methode (mstask.h)

  • Artikel

[[Diese API kann in nachfolgenden Versionen des Betriebssystems oder Produkts geändert oder nicht verfügbar sein. Verwenden Sie stattdessen die Taskplaner 2.0-Schnittstellen .] ]

Die SetTargetComputer-Methode wählt den Computer aus, auf dem die ITaskScheduler-Schnittstelle ausgeführt wird, wodurch die Remoteaufgabenverwaltung und -enumeration ermöglicht wird.

Syntax

HRESULT SetTargetComputer(
  [in] LPCWSTR pwszComputer
);

Parameter

[in] pwszComputer

Ein Zeiger auf eine mit NULL beendete breite Zeichenfolge, die den Namen des Zielcomputers für den aktuellen instance der ITaskScheduler-Schnittstelle angibt. Geben Sie den Namen des Zielcomputers im UNC-Format (Universal Naming Convention) an. Um den lokalen Computer anzugeben, legen Sie diesen Wert auf NULL oder auf den UNC-Namen des lokalen Computers fest.

Hinweis Verwenden Sie beim Angeben eines Remotecomputernamens zwei umgekehrte Schrägstriche (\\) vor dem Computernamen. Verwenden Sie beispielsweise "\\ComputerName" anstelle von "ComputerName".
 

Rückgabewert

Die SetTargetComputer-Methode gibt einen der folgenden Werte zurück.

Rückgabecode BESCHREIBUNG
S_OK
 Die Methode war erfolgreich.
SCHED_E_SERVICE_NOT_INSTALLED
 Der Taskplanerdienst ist auf dem Zielcomputer nicht installiert.
E_ACCESS_DENIED
 Der Benutzer hat keinen Zugriff auf den Remotecomputer.
E_INVALIDARG
 Der pwszComputer-Parameter ist ungültig.
E_OUTOFMEMORY
 Ein Fehler bei der Speicherzuordnung ist aufgetreten.

Hinweise

Damit ein Windows Server 2003- oder Windows XP-Computer Aufgaben auf einem Windows Vista-Computer erstellen, überwachen oder steuern kann, müssen die folgenden Vorgänge auf dem Windows Vista-Computer ausgeführt werden, und der Benutzer, der die ITaskScheduler::SetTargetComputer-Methode aufruft, muss Mitglied der Gruppe Administratoren auf dem Windows Vista-Remotecomputer sein.

Aktivieren der Ausnahme "Datei und Drucker freigeben" in der Windows-Firewall

  1. Klicken Sie auf Start und anschließend auf Systemsteuerung.
  2. Klicken Sie in Systemsteuerung auf Klassische Ansicht, und doppelklicken Sie dann auf das Symbol Windows-Firewall.
  3. Klicken Sie im Fenster Windows-Firewall auf die Registerkarte Ausnahmen , und aktivieren Sie das Kontrollkästchen Ausnahme datei- und Druckerfreigabe .

Aktivieren des Diensts "Remoteregistrierung"

  • Öffnen Sie ein Eingabeaufforderungsfenster, und geben Sie den folgenden Befehl ein: net start "Remote Registry"

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Windows XP [nur Desktop-Apps]
Unterstützte Mindestversion (Server) Windows Server 2003 [nur Desktop-Apps]
Zielplattform Windows
Kopfzeile mstask.h
Bibliothek Mstask.lib
DLL Mstask.dll

Weitere Informationen

ITaskScheduler