SLGetSAMLicense function

[SLGetSAMLicense is available for use in the operating systems specified in the Requirements section. It may be altered or unavailable in subsequent versions. ]

Retrieves information about an installed Software Asset Management (SAM) license.

Syntax

c++

HRESULT WINAPI SLGetSAMLicense(
  _In_  const SLID  *pApplicationId,
  _Out_       UINT  *pcbXmlLicenseData,
  _Out_       PBYTE *ppbXmlLicenseData
);

Parameters

• pApplicationId [in]
  A pointer to an SLID structure that specifies an application.

• pcbXmlLicenseData [out]
  A pointer to the size, in bytes, of the ppbXmlLicenseData array.

• ppbXmlLicenseData [out]
  A pointer to an array of BYTE pointers that specifies license file information about the application identified by the pApplicationId parameter.

  When you have finished using this array, free it by calling the LocalFree function.

Return value

If the method succeeds, it returns S_OK.

If the method fails, it returns an error code. For a list of common error codes, see Common HRESULT Values.

This function can return the following values defined in Slerror.h.

Return code/value	Description
SL_E_LICENSE_FILE_NOT_INSTALLED 0xC004F011	The software license file for the specified application does not exist.

 

Requirements

Minimum supported client	Windows Vista [desktop apps only]
Minimum supported server	Windows Server 2008 [desktop apps only]
Header	Slpublic.h
Library	Slc.lib
DLL	Slc.dll