CAPLfunctionC2xGetStationHandle

C2xGetStationHandle

Valid for: CANoe DE

Function Syntax

long C2xGetStationHandle(long packetHandle);
long C2xGetStationHandle(char *dbNodeName);

Description

Retrieve an ITS Station handle associated with a received packet or a database node. The handle can be used as input for the other functions of the Station API.

Parameters

• packetHandle: Handle of the received packet. This function is only usable in a CAPL callback that had been registered with C2xReceivePacket or with C2xRegisterCallback for Receive Indications.
• dbNodeName: Name of a database node. Returns the handle of the station which is assigned to the database node in the StationManager.

Return Values

• 0: Not available or failure
• ≠0: Station handle

Example

void OnC2xPacket (LONG channel, LONG dir, LONG radioChannel, LONG signalStrength, LONG sigQuality, LONG packet)
{
  long rxStationHdl;
  long dbStationHdl;

  rxStationHdl = C2xGetStationHandle(packet);
  dbStationHdl = C2xGetStationHandle("nodename");
}

• OnC2xPacket
• OnC2xTransmitPacket
• C2xAddToken
• C2xAssignNodeToStation
• C2xCompletePacket
• C2xConvertTimeFromMSSinceUTC
• C2xConvertTimeToMSSinceUTC
• C2xCreateStation
• C2xDisableMsg
• C2xEnableMsg
• C2xGetCycleTime
• C2xGetDefaultMacId
• C2xGetITSTimeStamp
• C2xGetLastError
• C2xGetLastErrorText
• C2xGetMessageName
• C2xGetNodeName
• C2xGetStationHandleByStationName
• C2xGetStationName
• C2xGetThisData
• C2xGetThisMotorolaValue16
• C2xGetThisMotorolaValue32
• C2xGetThisMotorolaValue64
• C2xGetThisTimeNS
• C2xGetThisValue16
• C2xGetThisValue32
• C2xGetThisValue64
• C2xGetThisValue8
• C2xGetTokenBitOfBitString
• C2xGetTokenBitString
• C2xGetTokenData
• C2xGetTokenInt
• C2xGetTokenInt64
• C2xGetTokenLengthBit
• C2xGetTokenOidElement
• C2xGetTokenString
• C2xGetTokenSubString
• C2xInitPacket
• C2xInitProtocol
• C2xIsMsgEnabled
• C2xIsNodeStarted
• C2xIsPacketValid
• C2xIsTokenAvailable
• C2xOutputPacket
• C2xProtocolAnalyzerGetRuleList
• C2xReceivePacket
• C2xRegisterCallback
• C2xReleasePacket
• C2xRemoveNodeAssignment
• C2xRemoveToken
• C2xReportProtocolViolation
• C2xResizeToken
• C2xSecCertificateCreate
• C2xSecCertificateGetHandle
• C2xSecCertificateGetHashedId8
• C2xSecCertificateGetName
• C2xSecCertificateGetSignerHandle
• C2xSecCertificateGetSignerHashedId8
• C2xSecCertificateGetStatus
• C2xSecPacketGetSignerHandle
• C2xSecPacketGetSignerHashedId8
• C2xSecPacketGetSignerType
• C2xSecPacketGetStatus
• C2xSecPacketIsSecured
• C2xSecPacketSetSignerHandle
• C2xSecPacketSetSignerType
• C2xSendMsg
• C2xSetCycleTime
• C2xSetSignal
• C2xSetStationSpeed
• C2xSetTokenBitOfBitString
• C2xSetTokenBitString
• C2xSetTokenData
• C2xSetTokenInt
• C2xSetTokenInt64
• C2xSetTokenOidElement
• C2xSetTokenString
• C2xSetVerbosity
• Car2x CAPL Functions
• Car2x Error Codes
• OnProtocolViolation
• OnScenarioStateChanged
• OnStartScenario
• OnStationAttributeTrigger
• OnStationAttributeTriggerAll
• SetStationSpeed

---