Edit

Share via

SLGetWindowsInformation function (slpublic.h)

  • Article

Retrieves the value portion of a name-value pair from the licensing policy of a software component.

Syntax

HRESULT SLGetWindowsInformation(
  [in]            PCWSTR     pwszValueName,
  [out, optional] SLDATATYPE *peDataType,
  [out]           UINT       *pcbValue,
  [out]           PBYTE      *ppbValue
);

Parameters

[in] pwszValueName

A pointer to a null-terminated string that contains the name associated with the value to retrieve.

[out, optional] peDataType

A pointer to a value of the SLDATATYPE enumeration that specifies the type of data in the ppbValue buffer.

[out] pcbValue

A pointer to the size, in bytes, of the ppbValue buffer.

[out] ppbValue

A pointer to an array of BYTE pointers that specifies the value associated with the name specified by the pwszValueName 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_VALUE_NOT_FOUND
0xC004F012
 The specified name-value pair was not found.
SL_E_RIGHT_NOT_GRANTED
0xC004F013
 The caller does not have the permissions necessary to call this function.

Requirements

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