CAPLfunctionC2xSecCertificateGetHandle

C2xSecCertificateGetHandle

Open topic with navigation

CAPL Functions » Car2x » C2xSecCertificateGetHandle

Function Syntax

long C2xSecCertificateGetHandle( char name[] );
long C2xSecCertificateGetHandle( byte hashedId8[] );

Description

Gets a certificate handle from a certificate listed in the Car2x Certificate Manager.

Parameters

• name: Name of the certificate as it is given in the Car2x Certificate Manager.
• hashedId8: hashedId8 digest of the certificate (e.g. included in the security header of a received frame), size must be 8 bytes. In some protocols this parameter is called certId8.

Return Values

• 0: Failure
• ≠0: Handle of the certificate

Example

// assumes a certificate with name "MyCert" was added to the configuration in the Car2x Certificate Manager dialog

long certificateHandle;
certificateHandle = C2xSecCertificateGetHandle( "MyCert" );

• CAPLCar2x
• C2xAddToken
• C2xAssignNodeToStation
• C2xCompletePacket
• C2xConvertTimeFromMSSinceUTC
• C2xConvertTimeToMSSinceUTC
• C2xCreateStation
• C2xDisableMsg
• C2xEnableMsg
• C2xGetCycleTime
• C2xGetDefaultMacId
• C2xGetITSTimeStamp
• C2xGetLastError
• C2xGetLastErrorText
• C2xGetMessageName
• C2xGetNodeName
• C2xGetStationHandle
• 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

---