Vorschau · Entwicklungsstand 1.6.1

ForegroundWindowQueryResult

Wofür ist das gedacht?

Typisierter Ergebnisvertrag ForegroundWindowQueryResult. Wird von der zugehörigen Windows-Abfrage geliefert. Die stabilen Ergebnis-IDs unten sind unabhängig von CLR-Namen und UI-Übersetzungen. Wähle im Ergebnis-Auswahldialog eine kompatible Eigenschaft statt das ganze Objekt ungeprüft als Text zu verwenden.

ForegroundWindowQueryResult verstehen

1
Zweck
Typisierter Ergebnisvertrag ForegroundWindowQueryResult. Wird von der zugehörigen Windows-Abfrage geliefert. Die stabilen Ergebnis-IDs unten sind unabhängig von CLR-Namen und UI-Übersetzungen. Wähle im Ergebnis-Auswahldialog eine kompatible Eigenschaft statt das ganze Objekt ungeprüft als Text zu verwenden.
2
Beispiel
Eine Ergebnisreferenz verwendet provider_id=step_result und source_id=v1/<kodierte-Step-ID>/<kodierte-Ergebnis-ID>. Die Anleitung „Werte verbinden“ zeigt eine vollständige Verbindung. Prüfe Typ und Kardinalität vor der Verwendung in einer Bedingung oder Folgeaktion.
3
Hinweise
Ein konfigurierte Quelle hat noch nicht zwingend einen Wert geliefert. Prüfe den fachlichen Erfolgswert, fehlende optionale Eigenschaften und den Ausführungszustand des Produzenten. Nur DynamicRoi besitzt die dokumentierte Ausnahme für späteres Feedback; andere Verbraucher dürfen keine beliebigen Vorwärtsreferenzen verwenden.

Orientierung für die Bedienung. Technische Verträge stehen im Entwicklerbereich am Seitenende.

Ergebniswerte verwenden

Ergebnis	Bedeutung
Exists	Ob der abgefragte Datei-/Ordnerpfad zum Beobachtungszeitpunkt existiert. Einzelwert dieses Ergebnisses.
Name	Lesbarer Name des abgefragten Geräts, Monitors, Laufwerks oder Objekts. Optionaler Einzelwert: bei fehlender Information keine Eigenschaft erfinden.
Text	Erkannter oder abgefragter Text. Er kann leer sein; Datentyp und Leerheitsprüfung vor einem nachfolgenden Vergleich beachten. Optionaler Einzelwert: bei fehlender Information keine Eigenschaft erfinden.
Id	System-/Geräteidentität des jeweiligen Ergebnisobjekts. Ihre Lebensdauer und Form hängen von der abgefragten Windows-Funktion ab. Optionaler Einzelwert: bei fehlender Information keine Eigenschaft erfinden.
Status	Vom zuständigen Windows-Dienst gemeldeter Zustand. Nicht durch frei erfundene Statusnamen ersetzen. Einzelwert dieses Ergebnisses.
Captured At	Zeitpunkt der Windows-Abfrage beziehungsweise Erfassung im Ergebnis. Er zeigt den Beobachtungsstand, nicht einen garantierten späteren Systemzustand. Einzelwert dieses Ergebnisses.
Error Code	Maschinenlesbarer Fehlercode einer Windows-Operation; bei Erfolg entsprechend dem Vertrag leer beziehungsweise nicht gesetzt. Optionaler Einzelwert: bei fehlender Information keine Eigenschaft erfinden.
Error Message	Lesbare Diagnose der Windows-Operation. Für Entscheidungen vorzugsweise Status und stabilen Code verwenden. Optionaler Einzelwert: bei fehlender Information keine Eigenschaft erfinden.

Beispiel

Eine Ergebnisreferenz verwendet provider_id=step_result und source_id=v1/<kodierte-Step-ID>/<kodierte-Ergebnis-ID>. Die Anleitung „Werte verbinden“ zeigt eine vollständige Verbindung. Prüfe Typ und Kardinalität vor der Verwendung in einer Bedingung oder Folgeaktion.

Vorbereitete Beispielabläufe ansehen

Fehler und Hinweise

Ein konfigurierte Quelle hat noch nicht zwingend einen Wert geliefert. Prüfe den fachlichen Erfolgswert, fehlende optionale Eigenschaften und den Ausführungszustand des Produzenten. Nur DynamicRoi besitzt die dokumentierte Ausnahme für späteres Feedback; andere Verbraucher dürfen keine beliebigen Vorwärtsreferenzen verwenden.

Entwickler- und Agenten-Doku JSON, Feldnamen, Typen und Verträge

Dieser Bereich erklärt die Bearbeitung von Textdateien und die technischen Verträge. Zur Entwickler-Doku

Identifier: ForegroundWindowQueryResult

Felder und Zusammenhänge auf einen Blick

1
ExistsErgebnis: exists · Wert
Ob der abgefragte Datei-/Ordnerpfad zum Beobachtungszeitpunkt existiert
2
NameErgebnis: name · Wert
Lesbarer Name des abgefragten Geräts, Monitors, Laufwerks oder Objekts
3
TextErgebnis: text · Wert
Erkannter oder abgefragter Text
4
IdErgebnis: id · Wert
System-/Geräteidentität des jeweiligen Ergebnisobjekts
5
StatusErgebnis: status · Wert
Vom zuständigen Windows-Dienst gemeldeter Zustand
6
Captured AtErgebnis: captured_at · Wert
Zeitpunkt der Windows-Abfrage beziehungsweise Erfassung im Ergebnis
7
Error CodeErgebnis: error_code · Wert
Maschinenlesbarer Fehlercode einer Windows-Operation; bei Erfolg entsprechend dem Vertrag leer beziehungsweise nicht gesetzt
8
Error MessageErgebnis: error_message · Wert
Lesbare Diagnose der Windows-Operation

Schematische Übersicht: Beschriftungen und Werte aus der Referenz, keine nachgezeichnete Bedienoberfläche.

Ergebnisvertrag

Ergebnis	Typ / Optionen	Anzahl	Erklärung
`exists`	`Boolean`	`Single`	Ob der abgefragte Datei-/Ordnerpfad zum Beobachtungszeitpunkt existiert. Einzelwert dieses Ergebnisses.
`name`	`Text`	`OptionalSingle`	Lesbarer Name des abgefragten Geräts, Monitors, Laufwerks oder Objekts. Optionaler Einzelwert: bei fehlender Information keine Eigenschaft erfinden.
`text`	`Text`	`OptionalSingle`	Erkannter oder abgefragter Text. Er kann leer sein; Datentyp und Leerheitsprüfung vor einem nachfolgenden Vergleich beachten. Optionaler Einzelwert: bei fehlender Information keine Eigenschaft erfinden.
`id`	`Text`	`OptionalSingle`	System-/Geräteidentität des jeweiligen Ergebnisobjekts. Ihre Lebensdauer und Form hängen von der abgefragten Windows-Funktion ab. Optionaler Einzelwert: bei fehlender Information keine Eigenschaft erfinden.
`status`	`Enum` `["Success", "Unsupported", "AccessDenied", "Timeout", "Failed"]`	`Single`	Vom zuständigen Windows-Dienst gemeldeter Zustand. Nicht durch frei erfundene Statusnamen ersetzen. Einzelwert dieses Ergebnisses. `Success` Windows-Aufruf erfolgreich. Erst anschließend den fachlichen Ergebniswert auswerten. `Unsupported` Funktion auf diesem Zielsystem nicht unterstützt. `AccessDenied` Windows verweigert den Zugriff; kein negativer fachlicher Zustand, sondern fehlende Berechtigung. `Timeout` Windows-Aufruf überschritt seine Zeitgrenze; daraus keinen Systemzustand ableiten. `Failed` Lauf wegen Fehler fehlgeschlagen.
`captured_at`	`DateTime`	`Single`	Zeitpunkt der Windows-Abfrage beziehungsweise Erfassung im Ergebnis. Er zeigt den Beobachtungsstand, nicht einen garantierten späteren Systemzustand. Einzelwert dieses Ergebnisses.
`error_code`	`Text`	`OptionalSingle`	Maschinenlesbarer Fehlercode einer Windows-Operation; bei Erfolg entsprechend dem Vertrag leer beziehungsweise nicht gesetzt. Optionaler Einzelwert: bei fehlender Information keine Eigenschaft erfinden.
`error_message`	`Text`	`OptionalSingle`	Lesbare Diagnose der Windows-Operation. Für Entscheidungen vorzugsweise Status und stabilen Code verwenden. Optionaler Einzelwert: bei fehlender Information keine Eigenschaft erfinden.

Diese Referenz für Textdateien und Agenten: Markdown · JSON-Vertrag