Retrieves the value portion of a name-value pair from the licensing policy of a software component.
Syntax
HRESULT WINAPI SLGetWindowsInformation(
__in PCWSTR pwszValueName,
__out SLDATATYPE *peDataType,
__out UINT *pcbValue,
__out PBYTE *ppbValue
);
Parameters
- pwszValueName [in]
-
A pointer to a null-terminated string that contains the name associated with the value to retrieve.
- peDataType [out]
-
A pointer to a value of the SLDATATYPE enumeration that specifies the type of data in the ppbValue buffer.
- pcbValue [out]
-
A pointer to the size, in bytes, of the ppbValue buffer.
- ppbValue [out]
-
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
|
Minimum supported client
| Windows Vista |
|
Minimum supported server
| Windows Server 2008 |
|
Header
|
- Slpublic.h
|
|
Library
|
- Slc.lib
|
|
DLL
|
- Slc.dll
|
Send comments about this topic to Microsoft
Build date: 9/7/2011