Edit

Share via

SLGetPolicyInformation function (slpublic.h)

  • Article

Gets the policy information after right has been consumed successfully.

Syntax

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

Parameters

[in] hSLC

Type: HSLC

The handle to the current SLC context.

[in] pwszValueName

Type: PCWSTR

The policy name.

[out, optional] peDataType

Type: SLDATATYPE*

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

Value Meaning
SL_DATA_SZ
 UNICODE string
SL_DATA_DWORD
 DWORD
SL_DATA_BINARY
 Binary BLOB

[out] pcbValue

Type: UINT*

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

[out] ppbValue

Type: PBYTE*

If successful, the data is returned in the buffer allocated by SLC. 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.
SL_E_VALUE_NOT_FOUND
0xC004F012
 The value for the input key was not found.
SL_E_RIGHT_NOT_GRANTED
0xC004F013
 The caller does not have permission to run the software.

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