Compartilhar via


Função SLQueryLicenseValueFromApp (slpublic.h)

[Essa API não está disponível para todos os aplicativos do Windows/Windows Phone. A menos que sua conta de desenvolvedor seja provisionada especialmente pela Microsoft, as chamadas para essas APIs falharão em runtime.]

Obtém o valor da política de componente especificada.

Sintaxe

HRESULT SLQueryLicenseValueFromApp(
  [in]            PCWSTR valueName,
  [out, optional] ULONG  *valueType,
  [out, optional] PVOID  dataBuffer,
  [in]            ULONG  dataSize,
  [out]           ULONG  *resultDataSize
);

Parâmetros

[in] valueName

O nome da política para a qual você deseja obter informações.

[out, optional] valueType

O tipo de dados do valor da política. A tabela a seguir descreve os valores que esse parâmetro pode receber.

Valor Descrição
REG_DWORD Um inteiro de 32 bits. Para esse tipo, o tamanho do buffer especificado pelo parâmetro dataBuffer deve ser de pelo menos 4 bytes.
REG_BINARY Um valor binário.
REG_SZ Uma cadeia de caracteres largo, terminada em nulo, incluindo o último caractere nulo.

[out, optional] dataBuffer

Um buffer que recebe o valor da política de componente.

[in] dataSize

O tamanho do buffer fornecido, em bytes.

[out] resultDataSize

O tamanho real dos dados recebidos para o valor da política, em bytes.

Retornar valor

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

Valor Significado
E_INVALIDARG
0x80070057
Um ou mais argumentos não são válidos.
SL_E_VALUE_NOT_FOUND
0xC004F012
O par nome-valor especificado não foi encontrado.

Comentários

Seu aplicativo deve ter a funcionalidade slapiQueryLicenseValue restrita para chamar a função SLQueryLicenseValueFromApp .

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows 10 [aplicativos da área de trabalho | Aplicativos UWP]
Servidor mínimo com suporte Windows Server 2016 [aplicativos da área de trabalho | Aplicativos UWP]
Plataforma de Destino Windows
Cabeçalho slpublic.h
Biblioteca Api-ms-win-core-slapi-l1-1-0.lib
DLL Api-ms-win-core-slapi-l1-1-0.dll