RtGetDongles

The function RtGetDongles retrieves a list of the IntervalZero-provided dongles attached to the machine.

Syntax

BOOL RtGetDongles(
	char ** dongleData,
	DWORD * dongleCount,
);

Parameters

dongleData

Pointer to an array of character pointers that point to buffers where dongle data is written. Each buffer must be allocated and must be at least DONGLE_ID_MAX_LENGTH +1 in length. This parameter can be NULL. When NULL, dongleCount is populated with the number of dongles found. Note that the caller must allocate enough array entries for the result parameter or the call will return FALSE with a status RT_GETLICENSES_RESULTS_BUFFER_TOO_SMALL.

dongleCount

This parameter is used to pass in the number of elements in the dongleData array. RtGetDongles fill this parameter in with the number of dongles found. This value cannot be NULL.

Return Values

Returns TRUE if the function succeeds; returns FALSE if the function fails. Call GetLastError to get extended error information if the call fails. Possible error codes are listed in the topic Licensing Error Codes.

Requirements

Minimum Supported Version	RTX 2016
Header	Rtapi.h
Library	Rtx_Rtss.lib

| |