Functions

  • GrdFindHandle grdFindFirst (uint32_t findFlags, const GrdFindMode *findMode, size_t findModeSize, GrdFindInfo *findInfo, size_t findInfoSize)
  • uint32_t grdFindNext (GrdFindHandle handle, GrdFindInfo *findInfo, size_t findInfoSize)
  • uint32_t grdFindClose (GrdFindHandle handle)
  • uint32_t grdGetAPIVersionNumber ()

 

Detailed Description

To iterate over all dongles in rare cases where the standard scenario is not enough to select the dongle Service functions

 

Function Documentation

 

GrdFindHandle grdFindFirst (uint32_tfindFlags, const GrdFindMode *findMode, size_tfindModeSize, GrdFindInfo *findInfo, size_tfindInfoSize)

Searches for a dongles that matches a specific search criteria

Parameters:

findFlags - Combination of GrdFM_xxx flags

findMode - A pointer to the GrdFindMode structure

findModeSize - Size of the GrdFindMode structure

findInfo - A pointer to the FindInfo structure

findInfoSize - Size of the findInfo buffer

Returns:

If the function succeeds, the return value is a search handle used in a subsequent call to grdFindNext or grdFindClose, and the findInfo parameter contains information from the first dongle found. If the function fails or fails to locate dongles from the search terms, the return value is INVALID_HANDLE

 

uint32_t grdFindNext (GrdFindHandlehandle, GrdFindInfo *findInfo, size_tfindInfoSize)

Continues a dongles search from a previous call to the grdFindFirst function

Parameters:

handle - The search handle returned by a previous call to the grdFindFirst function

findInfo - A pointer to the FindInfo structure

findInfoSize - Size of the findInfo buffer

Returns:

Returns zero if successful, otherwise an error code is returned

 

uint32_t grdFindClose (GrdFindHandlehandle)

The grdFindClose function closes handles previously opened with grdFindFirst function

Parameters:

handle - A valid handle value 

Returns:

Returns zero if successful, otherwise an error code is returned

 

uint32_t grdGetAPIVersionNumber ()

The grdGetAPIVersionNumber function returns the version number of the API. Use this function if your program uses functions and data structures that are not available in all API versions.

Returns:

Returns a number that indicates the API version number.

 

  • No labels