Função SLGetGenuineInformation (slpublic.h)

Artigo
08/26/2023

Obtém informações sobre o estado genuíno de um computador Windows.

Sintaxe

HRESULT SLGetGenuineInformation(
  [in]            const SLID *pQueryId,
  [in]            PCWSTR     pwszValueName,
  [out, optional] SLDATATYPE *peDataType,
  [out]           UINT       *pcbValue,
  [out]           BYTE       **ppbValue
);

Parâmetros

[in] pQueryId

Um ponteiro para uma estrutura SLID que especifica o aplicativo a ser marcar.

[in] pwszValueName

Um ponteiro para uma cadeia de caracteres terminada em nulo que contém o nome associado ao valor a ser recuperado. Os nomes a seguir são válidos.

Valor	Significado
SL_BRT_DATA	Obtenha um valor que especifica se o computador é original.
SL_BRT_COMMIT	Obtenha um valor que especifica se o computador está no modo de período de carência nãogenuine.
SL_GENUINE_RESULT	Obtenha o valor retornado da última chamada para a função SLAcquireGenuineTicket .
SL_NONGENUINE_GRACE_FLAG	Obtém a causa do computador que está sendo colocado no modo de período de carência nãogenuine.

[out, optional] peDataType

Um ponteiro para um valor da enumeração SLDATATYPE que especifica o tipo de dados no buffer ppbValue .

[out] pcbValue

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

[out] ppbValue

O endereço de um ponteiro para uma matriz de ponteiros BYTE que especifica o valor associado ao nome especificado pelo parâmetro pwszValueName .

Quando terminar de usar essa matriz, libere-a chamando a função LocalFree .

Valor retornado

Se o método for bem-sucedido, ele retornará S_OK.

Se o método falhar, ele retornará um código de erro. Para obter uma lista de códigos de erro comuns, consulte Valores HRESULT comuns.

Essa função pode retornar os seguintes valores definidos em Slerror.h.

Valor/código retornado	Descrição
SL_E_NOT_SUPPORTED 0xC004F016	Não há suporte para o nome especificado pelo parâmetro pwszValueName .
SL_E_VALUE_NOT_FOUND 0xC004F012	O par nome-valor especificado não foi encontrado.

Requisitos


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

Confira também

SLDATATYPE

SLGetWindowsInformation

Partilhar via