SK_PLUS_SystemIdentifierAddCurrentIdentifier Function

Adds a SystemIdentifier element to the list of current system identifiers.

Remarks

This function only needs to be called directly when implementing custom system identifier algorithms. Otherwise, the SK_PLUS_SystemIdentifierAlgorithmAddCurrentIdentifiers function should be called instead.

Syntax

C/C++
SK_ResultCode SK_PLUS_SystemIdentifierAddCurrentIdentifier(SK_ApiContext context, int flags, const char *name, const char *type, const char *value);
Visual Basic
Declare Function SK_PLUS_SystemIdentifierAddCurrentIdentifier(ByVal context As Long, ByVal flags As Long, ByVal name As String, ByVal type As String, ByVal value As String) As Long

Arguments

context
The API Context handle.
flags
Any flags passed into this function-call.
name
A name for the identifier being added, which must be unique or different from all other identifiers.
type
The type of identifier being added.
value
The plain-text value of the identification information.

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_DATA The presence of invalid data has been detected.
SK_ResultCode.SK_ERROR_INVALID_ARGUMENTS Some or all of the arguments are invalid.
SK_ResultCode.SK_ERROR_MEMORY_ALLOCATION Memory could not be allocated.