Função SLGetServiceInformation (slpublic.h)

  • Artigo

Obtém informações de dados globais.

Sintaxe

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

Parâmetros

[in] hSLC

Tipo: HSLC

O identificador para o contexto SLC atual.

[in] pwszValueName

Tipo: PCWSTR

O nome associado ao valor a ser recuperado. Os nomes a seguir são válidos.

Valor Significado
SL_INFO_KEY_VERSION
L"Version"
 Versão do serviço SL. por exemplo, "1.2.3.4"
SL_INFO_KEY_SYSTEM_STATE
L"SystemState"
 Estado do Sistema
SL_INFO_KEY_ACTIVE_PLUGINS
L"ActivePlugins"
 Caminhos de DLL totalmente qualificados para todos os plug-ins ativos (NULL delimitado e terminado em NULL duplo)
SL_INFO_KEY_SECURE_STORE_ID
L"SecureStoreId"
 GUID (ID do repositório seguro)
SL_INFO_KEY_SESSION_MACHINE_ID
L"SessionMachineId"
 ID do computador de sessão (BLOB binário)

[out, optional] peDataType

Tipo: SLDATATYPE*

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

Valor Significado
SL_DATA_SZ
 Cadeia de caracteres UNICODE
SL_DATA_DWORD
 DWORD
SL_DATA_BINARY
 Blob binário
SL_DATA_MULTI_SZ
 Matriz de cadeia de caracteres UNICODE terminada em nulo duplo

[out] pcbValue

Tipo: UINT*

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

[out] ppbValue

Tipo: PBYTE*

Se tiver êxito, os dados serão retornados no buffer alocado pelo SLC.
Quando terminar de usar a memória, libere-a chamando a função LocalFree .

Retornar valor

Tipo: HRESULT WINAPI

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

Valor/código retornado Descrição
E_INVALIDARG
0x80070057
 Um ou mais argumentos não são válidos.
SL_E_VALUE_NOT_FOUND
0xC004F012
 O valor da chave de entrada não foi encontrado.

Requisitos

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