# null

[Open topic with navigation](../../../../../CANoeDEFamily.htm#Topics/CAPLFunctions/IP/Methods/CAPLfunctionGetCurrentCipherSuite.md)

[CAPL Functions](../../CAPLfunctions.md) » [Ethernet](../CAPLEthernetStartPage.md) » [Function Overview](../CAPLfunctionsIPOverview.md) » EthernetMacsecSecureEntity::GetCurrentCipherSuite

# EthernetMacsecSecureEntity::GetCurrentCipherSuite

[Valid for](../../../Shared/FeatureAvailability.md):  CANoe DE

## Method Syntax

byte [EthernetMacsecSecureEntity](../Objects/CAPLfunctionEthernetMacsecSecureEntity.md).GetCurrentCipherSuite(qword& cipherSuiteId);

## Description

Returns the ID of the currently agreed MACsec cipher suite. The value will be one of:

* CS\_ID\_GCM\_AES\_128        0x0080c20001000001
* CS\_ID\_GCM\_AES\_256        0x0080c20001000002
* CS\_ID\_GCM\_AES\_XPN\_128    0x0080c20001000003
* CS\_ID\_GCM\_AES\_XPN\_256    0x0080c20001000004
* CS\_ID\_NULL               0xFFFFFFFFFFFFFFFF (if non-MACsec traffic has been agreed upon by MKA)
* CS\_ID\_INVALID            0x0000000000000000 (cipher suite has not been initialized yet or MKA has not completed yet).

## Parameters

* **cipherSuiteId**: The reference parameter where the queried value will be returned.

## Return Values

* **byte**: 1 if the call succeeded, 0 otherwise.

## Example

—\
Text
