RtGetDongles

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

Syntax

BOOL RtGetDongles(
	TCHAR** dongleData,
	PDWORD length
);

Parameters

dongleData

Pointer to an array of character pointers that point to buffers where unique identifying information about each dongle is written. Each buffer must be allocated by the caller and must be at least DONGLE_ID_MAX_LENGTH +1 in length. This parameter can be NULL. When NULL, the function will work but will not return unique identifying information about each dongle.

length

Before the call, this represents the number of elements passed from the dongleData array. After the call, this represents the number of dongles found. This value cannot be NULL.

Return Value

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

Requirements

Minimum Supported Version	RTX64 2014 with Service Pack 2
Header	Rtapi.h
Library	RtApi.lib (Windows), Rtx_Rtss.lib (RTSS)