DEENESPTFRRUARHIKOZHNL

स्ट्रक्चर ara::com::FindServiceHandle

[SWS_CM_00303] Upstream: RS_CM_00102

struct FindServiceHandle {...};

The exact definition of ara::com::FindServiceHandle is Communication Management implementation specific. ara::com::FindServiceHandle satisfies the [equalitycomparable] and [lessthancomparable] requirements as per [30] to allow storing and managing ara::com::FindServiceHandles by the application.

Literaturverzeichnis SWS CommunicationManagement: [30] ISO/IEC 14882:2014, Information technology – Programming languages – C++ – www.iso.org

Header-Datei#include "ara/com/service/find_service_handle.h"
Forwarding-Header#include "ara/com/com_fwd.h"
Scopenamespace ara::com

उपयोगकर्ता गाइडएआई जनित

सर्विस इंस्टेंसेस के लिए चल रही एसिंक्रोनस बैकग्राउंड खोज को प्रबंधित करने और समाप्त करने के लिए एक नियंत्रण टोकन के रूप में कार्य करता है।
एआई-जनित असत्यापित मॉडल: gemini-3.8-flash-medium · प्रयास: medium · तापमान: नियंत्रित नहीं किया जा सकता · प्रॉम्प्ट: eb9ee1985b4b उद्गम खुले प्रश्न (1)
जर्मन मार्गदर्शिका से अनूदितgemini-3.8-flash-low · 2026-10-13 · जर्मन मूल

सर्विस इंस्टेंसेस के लिए चल रही एसिंक्रोनस बैकग्राउंड खोज को प्रबंधित करने और समाप्त करने के लिए एक नियंत्रण टोकन के रूप में कार्य करता है।

स्ट्रक्चर ara::com::FindServiceHandle बैकग्राउंड में चल रही सर्विस मॉनिटरिंग को नियंत्रित करने के लिए एक अद्वितीय नियंत्रण टोकन के रूप में कार्य करता है (AUTOSAR_AP_EXP_ARAComAPI पृ. 34)। चूँकि डिफ़ॉल्ट कंस्ट्रक्टर डिलीट कर दिया गया है ([SWS_CM_00353]), हैंडल विशेष रूप से StartFindService द्वारा उत्पन्न किया जाता है और एसिंक्रोनस स्थिति कॉलबैक प्राप्त करने के बाद StopFindService के माध्यम से खोज के लक्षित समापन को सक्षम बनाता है (AUTOSAR_AP_EXP_ARAComAPI पृ. 30)। समर्थित तुलना ऑपरेटर मानक कंटेनरों में एकाधिक खोज अनुरोधों के संग्रहणीय प्रबंधन को भी सुनिश्चित करते हैं ([SWS_CM_11526], [SWS_CM_11527])।

संदर्भ

स्ट्रक्चर ara::com::FindServiceHandle Adaptive Platform के मॉड्यूल com में एक एसिंक्रोनस, निरंतर सर्विस खोज के लिए एक अद्वितीय पहचानकर्ता और नियंत्रण टोकन के रूप में कार्य करता है। जबकि FindService के माध्यम से एक सिंक्रोनस क्वेरी एक बार मिलान करने वाले सर्विस इंस्टेंसेस को निर्धारित करती है और सीधे हैंडल कंटेनर लौटाती है, StartFindService बैकग्राउंड में सेवा उपलब्धता की निरंतर निगरानी शुरू करता है (AUTOSAR_AP_EXP_ARAComAPI पृ. 34)। इस प्रक्रिया में आम तौर पर एप्लिकेशन इंस्टेंस, प्रकार-विशिष्ट प्रॉक्सी क्लास (उदाहरण के लिए RadarServiceProxy) और साथ ही FindServiceHandler प्रकार का एक उपयोगकर्ता-परिभाषित कॉलबैक फ़ंक्शन शामिल होता है (AUTOSAR_AP_EXP_ARAComAPI पृ. 30)। ara::com::FindServiceHandle का ठोस आंतरिक प्रतिनिधित्व संबंधित Communication Management के लिए कार्यान्वयन-विशिष्ट रूप से डिज़ाइन किया गया है, लेकिन हैंडलिंग के लिए मानकीकृत C++ इंटरफेस प्रदान करता है।

जीवनचक्र

ara::com::FindServiceHandle का जीवनचक्र Communication Management में सक्रिय खोज प्रक्रिया से दृढ़ता से जुड़ा हुआ है:

  • निर्माण: डिफ़ॉल्ट कंस्ट्रक्टर स्पष्ट रूप से डिलीट कर दिया गया है ([SWS_CM_00353])। इसलिए कोई एप्लिकेशन हैंडल इंस्टेंसेस को अनप्रारंभीकृत (uninitialized) या अनधिकृत रूप से नहीं बना सकता है। इसके बजाय, एक मान्य हैंडल स्थिर मेथड StartFindService द्वारा केवल ara::core::Result के पेलोड के रूप में उत्पन्न किया जाता है (AUTOSAR_AP_EXP_ARAComAPI पृ. 30)।
  • प्रबंधन और स्वामित्व: एक हैंडल कॉपी असाइनमेंट ऑपरेटर [SWS_CM_11528] के माध्यम से असाइनमेंट का समर्थन करता है। एप्लिकेशन को मानक कंटेनरों (जैसे क्रमित सेट या एसोसिएटिव ऐरे) में कई खोज अनुरोधों को संग्रहीत और व्यवस्थित करने में सक्षम बनाने के लिए, यह प्रकार ऑपरेटरों operator== ([SWS_CM_11526]) और operator< ([SWS_CM_11527]) के माध्यम से C++ अवधारणाओं [equalitycomparable] और [lessthancomparable] को पूरा करता है।
  • समापन और विनाश: हैंडल तब तक अपनी वैधता बनाए रखता है जब तक बैकग्राउंड मॉनिटरिंग सक्रिय रहती है। खोज की समाप्ति हैंडल को StopFindService में पास करके की जाती है (AUTOSAR_AP_EXP_ARAComAPI पृ. 30, AUTOSAR_AP_EXP_ARAComAPI पृ. 34)। इस कॉल के बाद, हैंडल अब किसी चालू खोज प्रक्रिया का प्रतिनिधित्व नहीं करता है।

उपयोग पथ

नियमित प्रवाह में खोज अनुरोध का पंजीकरण, उपलब्धता अपडेट्स की निरंतर प्राप्ति और निगरानी प्रक्रिया का व्यवस्थित ठहराव शामिल है:

  1. खोज प्रारंभ: नव उपलब्ध या हटाए गए सर्विस इंस्टेंसेस के बारे में सूचित होने के लिए एप्लिकेशन StartFindService के माध्यम से एक FindServiceHandler पंजीकृत करता है (AUTOSAR_AP_EXP_ARAComAPI पृ. 30, AUTOSAR_AP_EXP_ARAComAPI पृ. 34)।
  2. हैंडल प्राप्ति: सफल प्रारंभ होने पर, कॉल FindServiceHandle के साथ एक ara::core::Result लौटाता है (AUTOSAR_AP_EXP_ARAComAPI पृ. 30), जिसे एप्लिकेशन बाद के नियंत्रण कॉल्स के लिए सुरक्षित रखता है।
  3. एसिंक्रोनस सूचना: Communication Management बैकग्राउंड खोज करता है और स्थिति में बदलाव होने पर प्रदान किए गए हैंडलर को कॉल करता है (AUTOSAR_AP_EXP_ARAComAPI पृ. 34)।
  4. खोज ठहराव: जैसे ही इंस्टेंसेस मिल जाते हैं या मॉनिटरिंग की अब आवश्यकता नहीं होती है, एप्लिकेशन हैंडल को StopFindService में पास कर देता है (AUTOSAR_AP_EXP_ARAComAPI पृ. 30, AUTOSAR_AP_EXP_ARAComAPI पृ. 34)।
FindServiceHandle के साथ एसिंक्रोनस सर्विस खोज का प्रवाहApplikationProxyFindServiceHandlerStartFindService(handler)Result<FindServiceHandle>Use Case: बैकग्राउंड निगरानी सक्रियइंस्टेंस के बारे में अधिसूचनाUse Case: निगरानी की समाप्तिStopFindService(handle)

अनुक्रम आरेख (Sequence diagram): पंजीकरण से लेकर सूचनाओं के माध्यम से FindServiceHandle द्वारा समाप्त होने तक एसिंक्रोनस सर्विस खोज का विशिष्ट प्रवाह। स्रोत: AUTOSAR_AP_EXP_ARAComAPI पृ. 30, AUTOSAR_AP_EXP_ARAComAPI पृ. 34।

त्रुटि परिदृश्य

ara::com::FindServiceHandle का उपयोग करते समय निम्नलिखित सिस्टम-विशिष्ट बाधाओं पर ध्यान दिया जाना चाहिए:

  • विफल खोज प्रारंभ: यदि तकनीकी बाइंडिंग्स उपलब्ध नहीं हैं या सर्विस परिनियोजन कॉन्फ़िगरेशन त्रुटिपूर्ण है (AUTOSAR_AP_EXP_ARAComAPI पृ. 34), तो StartFindService विफल हो जाता है। इस मामले में लौटाए गए ara::core::Result में कोई मान्य हैंडल नहीं होता है, बल्कि एक एरर कोड होता है (AUTOSAR_AP_EXP_ARAComAPI पृ. 30)।
  • अपवाद सुरक्षा: कार्यान्वित तुलना और असाइनमेंट ऑपरेटर operator== ([SWS_CM_11526]), operator< ([SWS_CM_11527]) और operator= ([SWS_CM_11528]) विनिर्देश में स्पष्ट रूप से अपवाद-सुरक्षित नहीं (not exception safe) घोषित किए गए हैं।
  • एकाधिक ठहराव: उसी हैंडल के साथ StopFindService का दोहराया गया कॉल संभवतः अप्रभावी रहेगा या रनटाइम त्रुटि का कारण बन सकता है, क्योंकि अंतर्निहित निगरानी गतिविधि पहले ही हटा दी गई है। प्रश्न Q-f44130c33fa1caea (खुला)

यह मार्गदर्शिका Adaptive Platform (रिलीज़ R25-11) के लिए AUTOSAR विनिर्देश पर आधारित है। प्रस्तुत इंटरफेस और व्यवहार संदर्भित SWS आवश्यकताओं और API विवरणों पर आधारित हैं।

सदस्य मानचित्र

कंस्ट्रक्टर और डिस्ट्रक्टर

1

ऑपरेटर

3

क्लास आरेख

Hohle Dreieckspfeile = Vererbung (zeigt zur Basisklasse); Klicken öffnet die jeweilige Klassenseite.

G nara__com__FindServiceHandle138 «struct» FindServiceHandle + FindServiceHandle() + operator=() + operator<() + operator==()

विवरण दृश्य

रूपरेखा में कोई प्रविष्टि चुनें।

कंस्ट्रक्टर और डिस्ट्रक्टर

FindServiceHandle फ़ंक्शन

Default constructor deletion

FindServiceHandle ()=delete;

ऑपरेटर

operator< फ़ंक्शन

LessThan operator as per [lessthancomparable] in [30]

bool operator< (const FindServiceHandle &other) const;
operator= फ़ंक्शन

Copy assignment constructor

FindServiceHandle & operator= (const FindServiceHandle &other);
operator== फ़ंक्शन

Equality operator as per [equalitycomparable] in [30]

bool operator== (const FindServiceHandle &other) const;

मेथड का प्रलेखन

फ़ंक्शन FindServiceHandle [SWS_CM_00353] Upstream: RS_AP_00146

FindServiceHandle ()=delete;

Default constructor deletion

Header-Datei#include "ara/com/service/find_service_handle.h"
Scopestruct ara::com::FindServiceHandle

Request a governed re-review of this record. The record is not changed immediately.

Record
AUTOSAR/AP/record/SWS_CM_00353
Status
valid/unmigrated
Version
AUTOSAR/AP/record/SWS_CM_00353@rel:R25-11#e957edcd
Content hash
e957edcd
Source
https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_CommunicationManagement.pdf#nameddest=SWS_CM_00353
Status: valid/unmigrated Version: rel:R25-11#8a450052 Versionshistorie & Revisions (1 transition, 4 revision)
Current State
valid/unmigrated
Reason
mechanically backfilled by migriere_status_backfill.py -- no per-field curation history exists yet for this record
Campaign
2026-08-13-status-backfill
Active Version
AUTOSAR/AP/record/SWS_CM_00353@rel:R25-11#8a450052
Point-in-Time History:
Recorded Revisions (4):
  • R25-11rel:R25-11#b1f430d12026-09-30
  • R23-11rel:R23-11#604163032026-10-14
  • R24-11rel:R24-11#8a4500522026-10-14
  • R25-11rel:R25-11#8a4500522026-10-14 active
DateActorTransitionReason / RationaleCampaign
2026-08-13toolnone → valid/unmigratedmechanically backfilled by migriere_status_backfill.py -- no per-field curation history exists yet for this record2026-08-13-status-backfill

फ़ंक्शन operator< [SWS_CM_11527]

bool operator< (const FindServiceHandle &other) const;

LessThan operator as per [lessthancomparable] in [30]

Literaturverzeichnis SWS CommunicationManagement: [30] ISO/IEC 14882:2014, Information technology – Programming languages – C++ – www.iso.org

Header-Datei#include "ara/com/service/find_service_handle.h"
Scopestruct ara::com::FindServiceHandle
Exception-Sicherheitnot exception safe

Parameter (in)

ParameterBeschreibung
otherOther ara::com::FindServiceHandle to compare

Rückgabewert

TypBeschreibung
boolTRUE if other is less than *this, FALSE otherwise.

Request a governed re-review of this record. The record is not changed immediately.

Record
AUTOSAR/AP/record/SWS_CM_11527
Status
valid/unmigrated
Version
AUTOSAR/AP/record/SWS_CM_11527@rel:R25-11#11cf2592
Content hash
11cf2592
Source
https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_CommunicationManagement.pdf#nameddest=SWS_CM_11527
Status: valid/unmigrated Version: rel:R25-11#b1ec1ec0 Versionshistorie & Revisions (1 transition, 3 revision)
Current State
valid/unmigrated
Reason
mechanically backfilled by migriere_status_backfill.py -- no per-field curation history exists yet for this record
Campaign
2026-08-13-status-backfill
Active Version
AUTOSAR/AP/record/SWS_CM_11527@rel:R25-11#b1ec1ec0
Point-in-Time History:
Recorded Revisions (3):
  • R25-11rel:R25-11#9b3fc18e2026-09-30
  • R24-11rel:R24-11#2bb55cbe2026-10-14
  • R25-11rel:R25-11#b1ec1ec02026-10-14 active
DateActorTransitionReason / RationaleCampaign
2026-08-13toolnone → valid/unmigratedmechanically backfilled by migriere_status_backfill.py -- no per-field curation history exists yet for this record2026-08-13-status-backfill

फ़ंक्शन operator= [SWS_CM_11528]

FindServiceHandle & operator= (const FindServiceHandle &other);

Copy assignment constructor

Header-Datei#include "ara/com/service/find_service_handle.h"
Scopestruct ara::com::FindServiceHandle
Exception-Sicherheitnot exception safe

Parameter (in)

ParameterBeschreibung
otherOther ara::com::FindServiceHandle to copy

Rückgabewert

TypBeschreibung
FindServiceHandle &New ara::com::FindServiceHandle

Request a governed re-review of this record. The record is not changed immediately.

Record
AUTOSAR/AP/record/SWS_CM_11528
Status
valid/unmigrated
Version
AUTOSAR/AP/record/SWS_CM_11528@rel:R25-11#47683e93
Content hash
47683e93
Source
https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_CommunicationManagement.pdf#nameddest=SWS_CM_11528
Status: valid/unmigrated Version: rel:R25-11#847556b4 Versionshistorie & Revisions (1 transition, 3 revision)
Current State
valid/unmigrated
Reason
mechanically backfilled by migriere_status_backfill.py -- no per-field curation history exists yet for this record
Campaign
2026-08-13-status-backfill
Active Version
AUTOSAR/AP/record/SWS_CM_11528@rel:R25-11#847556b4
Point-in-Time History:
Recorded Revisions (3):
  • R25-11rel:R25-11#414d7a6c2026-09-30
  • R24-11rel:R24-11#f73bf3482026-10-14
  • R25-11rel:R25-11#847556b42026-10-14 active
DateActorTransitionReason / RationaleCampaign
2026-08-13toolnone → valid/unmigratedmechanically backfilled by migriere_status_backfill.py -- no per-field curation history exists yet for this record2026-08-13-status-backfill

फ़ंक्शन operator== [SWS_CM_11526]

bool operator== (const FindServiceHandle &other) const;

Equality operator as per [equalitycomparable] in [30]

Literaturverzeichnis SWS CommunicationManagement: [30] ISO/IEC 14882:2014, Information technology – Programming languages – C++ – www.iso.org

Header-Datei#include "ara/com/service/find_service_handle.h"
Scopestruct ara::com::FindServiceHandle
Exception-Sicherheitnot exception safe

Parameter (in)

ParameterBeschreibung
otherOther ara::com::FindServiceHandle to compare

Rückgabewert

TypBeschreibung
boolTRUE if other is equal to *this, FALSE otherwise.

Request a governed re-review of this record. The record is not changed immediately.

Record
AUTOSAR/AP/record/SWS_CM_11526
Status
valid/unmigrated
Version
AUTOSAR/AP/record/SWS_CM_11526@rel:R25-11#6ec8bee3
Content hash
6ec8bee3
Source
https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_CommunicationManagement.pdf#nameddest=SWS_CM_11526
Status: valid/unmigrated Version: rel:R25-11#d2ea98ee Versionshistorie & Revisions (1 transition, 3 revision)
Current State
valid/unmigrated
Reason
mechanically backfilled by migriere_status_backfill.py -- no per-field curation history exists yet for this record
Campaign
2026-08-13-status-backfill
Active Version
AUTOSAR/AP/record/SWS_CM_11526@rel:R25-11#d2ea98ee
Point-in-Time History:
Recorded Revisions (3):
  • R25-11rel:R25-11#d9c8643c2026-09-30
  • R24-11rel:R24-11#491d93d72026-10-14
  • R25-11rel:R25-11#d2ea98ee2026-10-14 active
DateActorTransitionReason / RationaleCampaign
2026-08-13toolnone → valid/unmigratedmechanically backfilled by migriere_status_backfill.py -- no per-field curation history exists yet for this record2026-08-13-status-backfill