Função SLGetApplicationInformation (slpublic.h)

Artigo
08/26/2023

Obtém informações sobre o aplicativo especificado.

Sintaxe

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

O identificador para o contexto SLC atual.

[in] pApplicationId

Tipo: const SLID*

Um ponteiro para a ID do aplicativo.

[in] pwszValueName

Tipo: PCWSTR

Valor	Significado
SL_INFO_KEY_IS_KMS L"IsKeyManagementService"	Indica se o computador tem um KMS (Serviço de Gerenciamento de Chaves) habilitado.
SL_INFO_KEY_KMS_CURRENT_COUNT L"KeyManagementServiceCurrentCount"	O número de clientes de volume em um host KMS que estão ativos no momento.
SL_INFO_KEY_KMS_REQUIRED_CLIENT_COUNT L"KeyManagementServiceRequiredClientCount"	O número mínimo de clientes VL necessários para se conectar a um host KMS para habilitar a ativação.
SL_INFO_KEY_KMS_UNLICENSED_REQUESTS L"KeyManagementServiceUnlicensedRequests"	O número de solicitações KMS de clientes VL com Status de Licença=Não Licenciado.
SL_INFO_KEY_KMS_LICENSED_REQUESTS L"KeyManagementServiceLicensedRequests"	O número de solicitações KMS de clientes VL com Status da Licença=Licenciado.
SL_INFO_KEY_KMS_OOB_GRACE_REQUESTS L"KeyManagementServiceOOBGraceRequests"	O número de solicitações KMS de clientes VL com Status de Licença=OOB Grace.
SL_INFO_KEY_KMS_OOT_GRACE_REQUESTS L"KeyManagementServiceOOTGraceRequests"	O número de solicitações KMS de clientes VL com Status de Licença=Carência OOT.
SL_INFO_KEY_KMS_NON_GENUINE_GRACE_REQUESTS L"KeyManagementServiceNonGenuineGraceRequests"	O número de solicitações KMS de clientes VL com Status de Licença=Cortesia Não Original.
SL_INFO_KEY_KMS_NOTIFICATION_REQUESTS L"KeyManagementServiceNotificationRequests"	O número de solicitações KMS de clientes VL com Status da Licença=Notificação.
SL_INFO_KEY_KMS_TOTAL_REQUESTS L"KeyManagementServiceTotalRequests"	Número total de solicitações KMS válidas.
SL_INFO_KEY_KMS_FAILED_REQUESTS L"KeyManagementServiceFailedRequests"	Número total de solicitações KMS com falha.

[out, optional] peDataType

Tipo: SLDATATYPE*

Um ponteiro para um valor da enumeração SLDATATYPE que especifica o tipo de dados no buffer ppbValue. Os valores a seguir são válidos.

Valor	Significado
SL_DATA_SZ	Cadeia de caracteres UNICODE
SL_DATA_DWORD	DWORD
SL_DATA_BINARY	Blob binário

[out] pcbValue

Tipo: UINT*

Um ponteiro para o tamanho, em bytes, do buffer ppbValue .

[out] ppbValue

Tipo: PBYTE*

Se tiver êxito, os dados serão retornados no buffer alocado pelo SLC.
Quando terminar de usar a memória, libere-a chamando a função LocalFree .

Retornar valor

Tipo: HRESULT WINAPI

Se essa função for bem-sucedida, ela retornará S_OK. Caso contrário, ele retornará um código de erro HRESULT.

Valor/código retornado	Descrição
E_INVALIDARG 0x80070057	Um ou mais argumentos não são válidos.
SL_E_VALUE_NOT_FOUND 0xC004F012	O valor da chave de entrada não foi encontrado.

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Windows 8 [somente aplicativos da área de trabalho]
Servidor mínimo com suporte	Windows Server 2012 [somente aplicativos da área de trabalho]
Plataforma de Destino	Windows
Cabeçalho	slpublic.h
Biblioteca	Slc.lib
DLL	Slc.dll