Función SLGetApplicationInformation (slpublic.h)

Artículo
08/26/2023

Obtiene información sobre la aplicación especificada.

Sintaxis

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

Parámetros

[in] hSLC

Tipo: HSLC

Identificador del contexto SLC actual.

[in] pApplicationId

Tipo: const SLID*

Puntero al identificador de la aplicación.

[in] pwszValueName

Tipo: PCWSTR

Valor	Significado
SL_INFO_KEY_IS_KMS L"IsKeyManagementService"	Indica si la máquina tiene habilitado un servicio de administración de claves (KMS).
SL_INFO_KEY_KMS_CURRENT_COUNT L"KeyManagementServiceCurrentCount"	Número de clientes de volumen en un host de KMS que están activos actualmente.
SL_INFO_KEY_KMS_REQUIRED_CLIENT_COUNT L"KeyManagementServiceRequiredClientCount"	El número mínimo de clientes de VL necesarios para conectarse a un host de KMS para habilitar la activación.
SL_INFO_KEY_KMS_UNLICENSED_REQUESTS L"KeyManagementServiceUnlicensedRequests"	Número de solicitudes de KMS de clientes de VL con estado de licencia=sin licencia.
SL_INFO_KEY_KMS_LICENSED_REQUESTS L"KeyManagementServiceLicensedRequests"	Número de solicitudes de KMS de clientes de VL con estado de licencia=con licencia.
SL_INFO_KEY_KMS_OOB_GRACE_REQUESTS L"KeyManagementServiceOOBGraceRequests"	Número de solicitudes de KMS de clientes de VL con estado de licencia=OOB Grace.
SL_INFO_KEY_KMS_OOT_GRACE_REQUESTS L"KeyManagementServiceOOTGraceRequests"	Número de solicitudes de KMS de clientes de VL con estado de licencia=OOT Grace.
SL_INFO_KEY_KMS_NON_GENUINE_GRACE_REQUESTS L"KeyManagementServiceNonGenuineGraceRequests"	Número de solicitudes de KMS de clientes de VL con estado de licencia=Gracia no original.
SL_INFO_KEY_KMS_NOTIFICATION_REQUESTS L"KeyManagementServiceNotificationRequests"	Número de solicitudes de KMS de clientes de VL con estado de licencia=notificación.
SL_INFO_KEY_KMS_TOTAL_REQUESTS L"KeyManagementServiceTotalRequests"	Número total de solicitudes KMS válidas.
SL_INFO_KEY_KMS_FAILED_REQUESTS L"KeyManagementServiceFailedRequests"	Número total de solicitudes de KMS con error.

[out, optional] peDataType

Tipo: SLDATATYPE*

Puntero a un valor de la enumeración SLDATATYPE que especifica el tipo de datos en el búfer ppbValue. Los valores siguientes son válidos.

Valor	Significado
SL_DATA_SZ	Cadena UNICODE
SL_DATA_DWORD	DWORD
SL_DATA_BINARY	Blob binario

[out] pcbValue

Tipo: UINT*

Puntero al tamaño, en bytes, del búfer ppbValue .

[out] ppbValue

Tipo: PBYTE*

Si se ejecuta correctamente, los datos se devuelven en el búfer asignado por el SLC.
Cuando termine de usar la memoria, libere la llamada a la función LocalFree .

Valor devuelto

Tipo: HRESULT WINAPI

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

Código o valor devuelto	Descripción
E_INVALIDARG 0x80070057	Uno o varios argumentos no son válidos.
SL_E_VALUE_NOT_FOUND 0xC004F012	No se encontró el valor de la clave de entrada.

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows 8 [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows Server 2012 [solo aplicaciones de escritorio]
Plataforma de destino	Windows
Encabezado	slpublic.h
Library	Slc.lib
Archivo DLL	Slc.dll