ITaskScheduler::SetTargetComputer-Methode (mstask.h)
[[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.
Rückgabewert
Die SetTargetComputer-Methode gibt einen der folgenden Werte zurück.
Rückgabecode | BESCHREIBUNG |
---|---|
|
Die Methode war erfolgreich. |
|
Der Taskplanerdienst ist auf dem Zielcomputer nicht installiert. |
|
Der Benutzer hat keinen Zugriff auf den Remotecomputer. |
|
Der pwszComputer-Parameter ist ungültig. |
|
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
- Klicken Sie auf Start und anschließend auf Systemsteuerung.
- Klicken Sie in Systemsteuerung auf Klassische Ansicht, und doppelklicken Sie dann auf das Symbol Windows-Firewall.
- 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 |