PLCnext API Documentation 23.6.0.37
Public Types | Public Member Functions | Static Public Member Functions | List of all members
Arp::Device::Interface::Services::IDeviceStatusService Class Referenceabstract

This service provides operations to read status information from the device. More...

#include <IDeviceStatusService.hpp>

Inheritance diagram for Arp::Device::Interface::Services::IDeviceStatusService:
Inheritance graph

Public Types

using Ptr = std::shared_ptr< IDeviceStatusService >
 
using GetItemsIdentifiersDelegate = delegate< void(IRscWriteEnumerator< RscString< 512 > > &)>
 
using GetItemsResultDelegate = delegate< void(IRscReadEnumerator< RscVariant< 512 > > &)>
 
- Public Types inherited from Arp::System::Rsc::Services::IRscService
typedef std::shared_ptr< IRscServicePtr
 

Public Member Functions

 IDeviceStatusService (void)=default
 Constructs an IDeviceStatusService instance.
 
virtual RscVariant< 512 > GetItem (const RscString< 512 > &identifier)=0
 This operation reads a single status information item. More...
 
virtual void GetItems (GetItemsIdentifiersDelegate identifiersDelegate, GetItemsResultDelegate resultDelegate)=0
 This operation reads a list of status information items. More...
 
- Public Member Functions inherited from Arp::System::Rsc::Services::IRscService
 IRscService (void)=default
 Constructs an IRscService instance.
 
virtual ~IRscService (void)=default
 Destructs this instance and frees all resouces.
 

Static Public Member Functions

static IRscServiceProxyFactory & GetProxyFactory (void)
 
- Static Public Member Functions inherited from Arp::System::Rsc::Services::IRscService
static IRscServiceProxyFactory & GetProxyFactory (void)
 Returns a reference to service proxy factory to create a proxy instance of the service More...
 

Detailed Description

This service provides operations to read status information from the device.

The service is defined in the library Arp.Device.Interface.
A current documentation of available device status information can be found in the Phoenix Contact "PLCnext Info Center", e.g.: PLCnext Info Center: IDeviceStatusService.

Realtime Usage: This API call does not have to be deterministic in runtime behaviour, so an asynchronous execution should be considered.

Member Function Documentation

◆ GetItem()

virtual RscVariant< 512 > Arp::Device::Interface::Services::IDeviceStatusService::GetItem ( const RscString< 512 > &  identifier)
pure virtual

This operation reads a single status information item.

Parameters
identifierString to select the respective status information item.
Returns
The result of the read operation as
Rsc container class for primitive data type, strings or information about arrays or structs....
Definition: RscVariant.hxx:69
on success,
RscType::Void
on error.

◆ GetItems()

virtual void Arp::Device::Interface::Services::IDeviceStatusService::GetItems ( GetItemsIdentifiersDelegate  identifiersDelegate,
GetItemsResultDelegate  resultDelegate 
)
pure virtual

This operation reads a list of status information items.

Parameters
identifiersArry of String select the respective status information items.
Returns
The result of the read operation as an array of on success,
RscType::Void
on error.

The documentation for this class was generated from the following file: