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

GetUserAddress1, GetUserAddress2, GetUserAddress3


The GetUserAddress1, GetUserAddress2 and GetUserAddress3 functions retrieve the User Address field (1, 2 or 3) stored in the currently loaded license.

Syntax

HRESULT GetUserAddress1 (

BSTR * UserAddress1

);

 

HRESULT GetUserAddress2 (

BSTR * UserAddress2

);

 

HRESULT GetUserAddress3 (

BSTR * UserAddress3

);

Parameters

UserAddressX

[OUT] Wide character string which will return with the (corresponding) User Address field stored in the currently loaded license.

Remarks

The GetUserAddress1, GetUserAddress2 and GetUserAddress3 functions retrieve the User Address field (1, 2 or 3) stored in the currently loaded license.  If the field is not set, the string returns empty.

These fields are dynamically allocated strings and have no declared maximum length. The theoretical maximum length of these string values is 2GB (two gigabytes). In practice this means that the maximum length of these strings is limited only by the amount of memory available to your application.

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