Compartir a través de

Función SLQueryLicenseValueFromApp (slpublic.h)

  • Artículo

[Esta API no está disponible para todas las aplicaciones de Windows o Windows Phone. A menos que Microsoft aprovisione especialmente la cuenta de desarrollador, se producirá un error en las llamadas a estas API en tiempo de ejecución.

Obtiene el valor de la directiva de componentes especificada.

Sintaxis

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

Parámetros

[in] valueName

Nombre de la directiva para la que desea obtener información.

[out, optional] valueType

Tipo de datos del valor de la directiva. En la tabla siguiente se describen los valores que puede recibir este parámetro.

Valor Descripción
REG_DWORD Entero de 32 bits. Para este tipo, el tamaño del búfer que especifica el parámetro dataBuffer debe ser de al menos 4 bytes.
REG_BINARY Valor binario.
REG_SZ Cadena terminada en caracteres anchos y terminada en NULL, incluido el último carácter NULL.

[out, optional] dataBuffer

Búfer que recibe el valor de la directiva de componentes.

[in] dataSize

Tamaño del búfer proporcionado, en bytes.

[out] resultDataSize

Tamaño real de los datos recibidos para el valor de la directiva, en bytes.

Valor devuelto

Si esta función se realiza correctamente, devuelve S_OK. De lo contrario, devuelve un código de error de HRESULT.

Valor Significado
E_INVALIDARG
0x80070057
 Uno o varios argumentos no son válidos.
SL_E_VALUE_NOT_FOUND
0xC004F012
 No se encontró el par nombre-valor especificado.

Comentarios

La aplicación debe tener la funcionalidad restricted slapiQueryLicenseValue para llamar a la función SLQueryLicenseValueFromApp .

Requisitos

Requisito Value
Cliente mínimo compatible Windows 10 [aplicaciones de escritorio | Aplicaciones para UWP]
Servidor mínimo compatible Windows Server 2016 [aplicaciones de escritorio | Aplicaciones para UWP]
Plataforma de destino Windows
Encabezado slpublic.h
Library Api-ms-win-core-slapi-l1-1-0.lib
Archivo DLL Api-ms-win-core-slapi-l1-1-0.dll