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.

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

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.

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.