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.