SLQueryLicenseValueFromApp 函数 (slpublic.h)

  • 项目

[此 API 并非适用于所有 Windows/Windows Phone 应用。 除非你的开发人员帐户由 Microsoft 专门预配，否则对这些 API 的调用将在运行时失败。]

获取指定组件策略的值。

语法

HRESULT SLQueryLicenseValueFromApp(
  [in]            PCWSTR valueName,
  [out, optional] ULONG  *valueType,
  [out, optional] PVOID  dataBuffer,
  [in]            ULONG  dataSize,
  [out]           ULONG  *resultDataSize
);

参数

[in] valueName

要获取其信息的策略的名称。

[out, optional] valueType

策略值的数据类型。 下表描述了此参数可以接收的值。

值 说明
REG_DWORD 32 位整数。 对于此类型， dataBuffer 参数指定的缓冲区大小应至少为 4 个字节。
REG_BINARY 二进制值。
REG_SZ 以 null 结尾的宽字符字符串，包括最后一个 null 字符。

[out, optional] dataBuffer

接收组件策略的值的缓冲区。

[in] dataSize

提供的缓冲区的大小（以字节为单位）。

[out] resultDataSize

为策略值接收的数据的实际大小（以字节为单位）。

返回值

如果此函数成功，则返回 S_OK。 否则，将返回 HRESULT 错误代码。

值 含义
E_INVALIDARG
0x80070057
 一个或多个参数无效。
SL_E_VALUE_NOT_FOUND
0xC004F012
 找不到指定的名称/值对。

注解

你的应用必须具有受限的 slapiQueryLicenseValue 功能才能调用 SLQueryLicenseValueFromApp 函数。

要求

要求 值
最低受支持的客户端 Windows 10 [桌面应用 |UWP 应用]
最低受支持的服务器 Windows Server 2016 [桌面应用 |UWP 应用]
目标平台 Windows
标头 slpublic.h
Library Api-ms-win-core-slapi-l1-1-0.lib
DLL Api-ms-win-core-slapi-l1-1-0.dll