ICredentialsProvider.GetCredentials (METH) ¶ METHOD GetCredentials : SysTypes.RTS_IEC_RESULT Must return ERR_OK if called after a successfull ICredentialsProvider.IsGetCredentialsFinished InOut: Scope Name Type Comment Return GetCredentials SysTypes.RTS_IEC_RESULT Input uxiRequestId __UXINT The request id to get the credentials for Output credentials ICredentials The resulting credentials of the current implementation. Note Please remark that the returned object is not required to be alive longer than to the next calls on this object using the interface ICredentialsProvider
ICredentialsProvider.IsGetCredentialsFinished (METH) ¶ METHOD IsGetCredentialsFinished : SysTypes.RTS_IEC_RESULT Will return ERR_OK if the request is finished, ERR_PENDING if it is not yet finished, ERR_DS_RETRYLOGIN if the login should be tried again, another error code in case of an error InOut: Scope Name Type Comment Return IsGetCredentialsFinished SysTypes.RTS_IEC_RESULT Input uxiRequestId __UXINT The request id to check the result for
ICredentialsProvider.LoginFailed (METH) ¶ METHOD LoginFailed : SysTypes.RTS_IEC_RESULT Will be called when a login failed due to wrong credentials The behaviour of the datasource afterwards depends on the return value. In case of ERR_PENDING, the logincycle will be started again with a call to GetCredentials. In all other cases the driver will go to it’s error state. InOut: Scope Name Type Comment Return LoginFailed SysTypes.RTS_IEC_RESULT Input uxiRequestId __UXINT Output tRetryWaitTime TIME The time that is waited until the next try to login is started
ICredentialsProvider.LoginSucceeded (METH) ¶ METHOD LoginSucceeded Will be called when after a successful login. InOut: Scope Name Type Input uxiRequestId __UXINT
ICredentialsProvider.StartGetCredentials (METH) ¶ METHOD StartGetCredentials : __UXINT Will return an id of the question for credentials. This id can be used in the following calls to ICredentialsProvider.IsGetCredentialsFinished InOut: Scope Name Type Comment Return StartGetCredentials __UXINT Input pstDataSource POINTER TO STRING The name of the datasource to request credentials for. Can be used as an informative hint to the user for example. Output udiErrorCode SysTypes.RTS_IEC_RESULT An error code representing the result of this operation. In case of ERR_PENDING there will be further calls to this method.
ICredentialsUserPassword (ITF) ¶ INTERFACE ICredentialsUserPassword EXTENDS ICredentials An implementation of credentials that represents a username and a password. Properties: Password Username Structure: Password (Property) Username (Property)
IDataItem.SizeRemote (PROP) ¶ PROPERTY SizeRemote : __UXINT Returns the size of the variable represented by this item on the remote device (the one IDriver connects to.
IDataItemValueAssigner (ITF) ¶ INTERFACE IDataItemValueAssigner EXTENDS __SYSTEM.IQueryInterface Implementations of this interface represent a mechanism for assigning values retrieved from a device connected by a IDriver to the local value or the other way round. Methods: GetRawValue SetRawValue Structure: GetRawValue (Method) SetRawValue (Method)
IDataItemValueAssigner.GetRawValue (METH) ¶ METHOD GetRawValue : POINTER TO BYTE This method can be called to retrieve the value in a form that can be written to a device connected by a IDriver from the local value InOut: Scope Name Type Comment Return GetRawValue POINTER TO BYTE A pointer to the data that should be sent. The data will be in byte order according to IDriver.DataByteOrder and the size will be the one returned by IDataItem.SizeRemote Important The returned value will not be guaranteed to be valid longer than the typically current call of IDriverStateMachine.SendRequest
IDataItemValueAssigner.SetRawValue (METH) ¶ METHOD SetRawValue This method can be called to assign a value retrieved from a device connected by a IDriver to the local value InOut: Scope Name Type Comment Input pData POINTER TO BYTE A pointer to the data retrieved from the device. The byte order is expected to be IDriver.DataByteOrder and the size is IDataItem.SizeRemote
