SoftwareShield ClientProtector COM Component > ClientProtector (SSCProtector) Reference > GetAllSerialNumbers

GetAllSerialNumbers


The GetAllSerialNumbers function returns all stored Serial Numbers in the currently loaded license.

Syntax

HRESULT GetAllSerialNumbers (

BSTR * SerialNumberList

) ;

Parameters

SerialNumberList

[OUT] This is (a pointer to) a string value that returns with a list of all the Serial Numbers (if any) stored in this license.  See remarks below for format.

Remarks

The GetAllSerialNumbers function returns all stored Serial Numbers in the currently loaded license. The maximum number possibly returned is 64 (one inside each Authorization Definition).

The format of the returned string is a comma separated list of name/value pairs.  Each name/value pair is the Authorization Definition ID (name) and the associated Serial Number (value).  Name/value pairs are separated by the equals sign.  There are no spaces in the string.

Example:  "0=B39K-J7A2-0KBE-9B3B,5=VQWK-F4E6-BHWT-TNP8,31=C282-BTEX-E7G9-LFDM".  This corresponds to three Serial Numbers being stored in the license.  One for each of the definitions 0, 5 and 31.

Note that Authorization Definitions which exist in the license, but do not contain a Serial Number are not returned.  

Return Value

As with all COM function calls they return an HRESULT. HRESULT is a data type that is a 32-bit error or warning code. Check your compilers documentation for information on interpreting the HRESULT value.

Function Information

Exposed By Interface:

"ISSCProtector"

Exposed In COM Server Binaries:

"SSCProt.dll" and "SSCProtD.dll"

Related Topics