Função SLGetWindowsInformation (slpublic.h)

  • Artigo

Recupera a parte de valor de um par nome-valor da política de licenciamento de um componente de software.

Sintaxe

HRESULT SLGetWindowsInformation(
  [in]            PCWSTR     pwszValueName,
  [out, optional] SLDATATYPE *peDataType,
  [out]           UINT       *pcbValue,
  [out]           PBYTE      *ppbValue
);

Parâmetros

[in] pwszValueName

Um ponteiro para uma cadeia de caracteres terminada em nulo que contém o nome associado ao valor a ser recuperado.

[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

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 .

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

Valor/código retornado Descrição
SL_E_VALUE_NOT_FOUND
0xC004F012
 O par nome-valor especificado não foi encontrado.
SL_E_RIGHT_NOT_GRANTED
0xC004F013
 O chamador não tem as permissões necessárias para chamar essa função.

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