SNIP_CLASSIC_OS_SECTION_8_4_7_CheckObjectAccess
Wortlaut
8.4.7 CheckObjectAccess
[SWS_Os_00256] Definition of API function CheckObjectAccess
Upstream requirements: SRS_Os_11010
⌈
Service Name
CheckObjectAccess
Syntax
ObjectAccessType CheckObjectAccess (
ApplicationType ApplID,
ObjectTypeType ObjectType,
void ...
)
Service ID [hex]
0x05
Sync/Async
Synchronous
Reentrancy
Reentrant
ApplID
OS-Application identifier
ObjectType
Type of the following parameter
Parameters (in)
...
The object to be examined
Parameters (inout)
None
Parameters (out)
None
Return value
ObjectAccessType
ACCESS if the ApplID has access to the object
NO_ACCESS otherwise
Description
This service determines if the OS-Applications, given by ApplID, is allowed to use the IDs of a
Task, Resource, Counter, Alarm or Schedule Table in API calls.
Available via
Os.h
⌋
[SWS_Os_00271]
Upstream requirements: SRS_Os_11001
⌈If the OS-Application <ApplID> in a call of CheckObjectAccess has access to the
queried object, CheckObjectAccess shall return ACCESS.⌋
[SWS_Os_00272]
Upstream requirements: SRS_Os_11001
⌈If the OS-Application <ApplID> in a call of CheckObjectAccess has no access to
the queried object, CheckObjectAccess shall return NO_ACCESS.⌋
[SWS_Os_00423]
Upstream requirements: SRS_Os_11001
⌈If in a call of CheckObjectAccess the object to be examined is not a valid object
OR <ApplID> is invalid OR <ObjectType> is invalid THEN CheckObjectAccess shall
return NO_ACCESS.⌋
[SWS_Os_00519]
Upstream requirements: SRS_Os_11016
⌈Availability of CheckObjectAccess: Available in Scalability Classes 3 and 4.⌋
Versionen & Provenienz · Zugeordnete Anforderungen
Diese Angaben zeigt der Versions-Explorer.
Begründung & Zuweisungs-Evidenz
ObjectTypeType definition used by CheckObjectAccess
Dokumenten-Herkunft & Rückverfolgbarkeit
| Spezifikations-Dokument | SWS_OS.pdf |
|---|---|
| Dokumentseite | Seite 177 |
| Ziel-Modul | os (classic) |
| Ziel-Anforderung | SWS_Os_00779 |
| Semantische Rolle | heuristic |
| Automatisierungs-Konfidenz | 0.80 |