SK_PLUS_SystemIdentifierAlgorithmAddCurrentIdentifiers Function

Adds SystemIdentifier elements to the list of current system identifiers using the specified, built-in algorithm.

Remarks

Important Note

In versions 5.13.3.0 and earlier of PLUSNative, an older macOS implementation of the SK_SystemIdentifierAlgorithm.SK_SYSTEM_IDENTIFIER_ALGORITHM_HARD_DISK_VOLUME_SERIAL algorithm was used. To retain compatibility with the older macOS implementation (which may be necessary to avoid requiring your customers to reactivate after upgrading the PLUSNative library), you can specify the SK_FLAGS_SYSTEMIDENTIFIER_HARDDISKVOLUMESERIALS_LEGACYOSX flag.

Syntax

C/C++
SK_ResultCode SK_PLUS_SystemIdentifierAlgorithmAddCurrentIdentifiers(SK_ApiContext context, int flags, SK_SystemIdentifierAlgorithm algorithm, const char *algorithmDataString, int *count);
Visual Basic
Declare Function SK_PLUS_SystemIdentifierAlgorithmAddCurrentIdentifiers(ByVal context As Long, ByVal flags As Long, ByVal algorithm As Long, ByVal algorithmDataString As String, ByRef count As Long) As Long

Arguments

context
The API Context handle.
flags
Any flags passed into this function-call.
algorithm
The SK_SystemIdentifierAlgorithm value, which identifies the algorithm that will be used when computing the system identifier data.
algorithmDataString
May be used in the future as a plain-text, string value to send to certain algorithms. Pass NULL or zero (0) for this parameter.
count
Reference/pointer to an integer, which will point to the number of system identifiers added when the call succeeds.

Returns

All possible return values are included in the SK_ResultCode enumeration. Return codes to expect include:

Result Code Description
SK_ResultCode.SK_ERROR_NONE No error.
SK_ResultCode.SK_ERROR_INVALID_ARGUMENTS Some or all of the arguments are invalid.