Last Modified October 1, 2026

DNA_GetRequestKey() API

DNA_GetRequestKey()

DNA_GetRequestKey(requestKey, sizeOfKey)

DNA_GetRequestKey() is used as the 1st step in the OffNet Activation Process to retrieve the <RequestKey> unique to the device.

The <Request_key> is used to generate the <Confirmation_key> in the DNA Control Panel, or from a OffNet Activation portal.

See OffNet Activation for details.

DNA_GetRequestKey() : JAVA, VB.NET, C#.NET
Parameters Description
DNA_GetRequestKey(requestKey, sizeOfKey) : Pascal, VBasic, C, C++, ObjectiveC
Parameters Description
<requestKey>

Buffer or pointer to Buffer that will hold the retrieved value of the <requestKey>

<sizeOfKey>

Size of the buffer that will hold the retrieved value of the <requestKey>.
Recommended size is 2,048 bytes.

VB.NET
C#.NET
JAVA

DNA_GetRequestKey() returns a string with the value of the <requestKey> as part of the OffNet Activation process.

For all other languages
API Result Description
0

the value of <requestKey> is returned in the parameter <requestKey> as part of the OffNet Activation process.

99

The size of the buffer <requestKey> is too small to store the value of the Request Key.