SLGetReferralInformation function (slpublic.h)

Gets referral information for the specified product.

Syntax

HRESULT SLGetReferralInformation(
  [in]  HSLC           hSLC,
  [in]  SLREFERRALTYPE eReferralType,
  [in]  const SLID     *pSkuOrAppId,
  [in]  PCWSTR         pwszValueName,
  [out] PWSTR          *ppwszValue
);

Parameters

[in] hSLC

Type: HSLC

The handle retrieved by previous call to the SLOpen function.

[in] eReferralType

Type: SLREFERRALTYPE

The referral type.

[in] pSkuOrAppId

Type: const SLID*

A pointer to the SLID of the application or SKU from which to obtain information.

[in] pwszValueName

Type: PCWSTR

The name associated with the value to retrieve. The following names are valid.

Value Meaning
SL_PARTNERID
Partner ID for the license reseller
SL_REFERRALID
Referral ID for the license reseller
SL_MERCHANTCOMMERCEURL
The merchant URL to purchase additional licenses
SL_MERCHANTUPGRADEURL
The merchant URL to purchase additional licenses
SL_DOWNLOADURL
A forward link to download the associated application
SL_INSTALLATIONPARAMETERS
Any parameters that are used when running the associated application's installer
SL_MERCHANTSUPPORTPHONENUMBER
The merchant support phone number(s)
SL_MERCHANTSUPPORTEMAIL
The merchant support email address
SL_MERCHANTSUPPORTURL
The merchant support URL
SL_SERIALIZEDDATA
A generic data BLOB

[out] ppwszValue

Type: PWSTR*

The value to store. When finished using the memory, free it by calling the LocalFree function.

Return value

Type: HRESULT WINAPI

If this function succeeds, it return S_OK. Otherwise, it returns an HRESULT error code.

Return code/value Description
E_INVALIDARG
0x80070057
One or more arguments are not valid.

Requirements

Requirement Value
Minimum supported client Windows 8 [desktop apps only]
Minimum supported server Windows Server 2012 [desktop apps only]
Target Platform Windows
Header slpublic.h
Library Slc.lib
DLL Slc.dll