SLGetWindowsInformation function

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

Syntax

HRESULT SLGetWindowsInformation(
  PCWSTR     pwszValueName,
  SLDATATYPE *peDataType,
  UINT       *pcbValue,
  PBYTE      *ppbValue
);

Parameters

pwszValueName

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

peDataType

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

pcbValue

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

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

   
Windows version Windows Vista [desktop apps only] Windows Server 2008 [desktop apps only]
Target Platform Windows
Header slpublic.h
Library Slc.lib
DLL Slc.dll