Função SLSetGenuineInformation (slpublic.h)

  • Artigo

Especifica informações sobre o status original de um computador Windows.

Sintaxe

HRESULT SLSetGenuineInformation(
  [in]           const SLID *pQueryId,
  [in]           PCWSTR     pwszValueName,
  [in]           SLDATATYPE eDataType,
  [in, optional] UINT       cbValue,
  [in, optional] const BYTE *pbValue
);

Parâmetros

[in] pQueryId

Um ponteiro para uma estrutura SLID que especifica o aplicativo para o qual definir informações.

[in] pwszValueName

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

Valor Significado
SL_BRT_DATA
 Defina informações sobre o estado original do computador.
SL_BRT_COMMIT
 Se o valor SL_BRT_DATA for definido, a configuração SL_BRT_COMMIT colocará o computador no modo de período de carência nãogenuine.

[in] eDataType

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

[in, optional] cbValue

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

[in, optional] pbValue

Um ponteiro para uma matriz de valores BYTE que especificam o valor associado ao nome especificado pelo parâmetro pwszValueName .

Alguns pares nome-valor permitem que esse parâmetro seja NULL. Nesse caso, o valor existente do par nome-valor é excluído.

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

Retornar valor

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 Winerror.h e Slerror.h.

Valor/código retornado Descrição
E_ACCESS_DENIED
0x80070005
 O chamador não tem privilégios administrativos.
E_INVALIDARG
0x80000003
 O parâmetro pbValue não pode ser NULL.
(HRESULT_FROM_WIN32) ERROR_BUFFER_OVERFLOW
0x111
 O buffer pbValue é muito pequeno para conter os dados.
SL_E_DATATYPE_MISMATCHED
0xC004F01E
 O tipo de dados do parâmetro pbValue não corresponde ao tipo especificado pelo parâmetro eDataType .
SL_E_DEPENDENT_PROPERTY_NOT_SET
0xC004F066
 O par nome-valor especificado depende de um par nome-valor que não foi definido.
SL_E_NOT_SUPPORTED
0xC004F016
 Não há suporte para o nome especificado pelo parâmetro pwszValueName .

Requisitos

Requisito Valor
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