Função SLGetGenuineInformation (slpublic.h)

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