nf-slpublic-slgetserviceinformation.md

UID	title	description	helpviewer_keywords	old-location	tech.root	ms.assetid	ms.date	ms.keywords	req.header	req.include-header	req.target-type	req.target-min-winverclnt	req.target-min-winversvr	req.kmdf-ver	req.umdf-ver	req.ddi-compliance	req.unicode-ansi	req.idl	req.max-support	req.namespace	req.assembly	req.type-library	req.lib	req.dll	req.irql	targetos	req.typenames	req.redist	ms.custom	f1_keywords	dev_langs	topic_type	api_type	api_location	api_name
NF:slpublic.SLGetServiceInformation	SLGetServiceInformation function (slpublic.h)	Gets global data information.	SLGetServiceInformation SLGetServiceInformation function [Security] SL_DATA_BINARY SL_DATA_DWORD SL_DATA_MULTI_SZ SL_DATA_SZ SL_INFO_KEY_ACTIVE_PLUGINS SL_INFO_KEY_SECURE_STORE_ID SL_INFO_KEY_SESSION_MACHINE_ID SL_INFO_KEY_SYSTEM_STATE SL_INFO_KEY_VERSION security.slgetserviceinformation slpublic/SLGetServiceInformation	security\slgetserviceinformation.htm	security	c8c932af-c716-425a-8c37-ad3b749dd985	12/05/2018	SLGetServiceInformation, SLGetServiceInformation function [Security], SL_DATA_BINARY, SL_DATA_DWORD, SL_DATA_MULTI_SZ, SL_DATA_SZ, SL_INFO_KEY_ACTIVE_PLUGINS, SL_INFO_KEY_SECURE_STORE_ID, SL_INFO_KEY_SESSION_MACHINE_ID, SL_INFO_KEY_SYSTEM_STATE, SL_INFO_KEY_VERSION, security.slgetserviceinformation, slpublic/SLGetServiceInformation	slpublic.h		Windows	Windows 8 [desktop apps only]	Windows Server 2012 [desktop apps only]										Slc.lib	Slc.dll		Windows			19H1	SLGetServiceInformation slpublic/SLGetServiceInformation	c++	APIRef kbSyntax	DllExport	Slc.dll	SLGetServiceInformation

SLGetServiceInformation function

-description

Gets global data information.

-parameters

-param hSLC [in]

Type: HSLC

The handle to the current SLC context.

-param pwszValueName [in]

Type: PCWSTR

The name associated with the value to retrieve. The following names are valid.

Value	Meaning
SL_INFO_KEY_VERSION L"Version"	Version of SL service. e.g. "1.2.3.4"
SL_INFO_KEY_SYSTEM_STATE L"SystemState"	System State
SL_INFO_KEY_ACTIVE_PLUGINS L"ActivePlugins"	Fully-qualified DLL paths for all active plugins (NULL delimited and double NULL-terminated)
SL_INFO_KEY_SECURE_STORE_ID L"SecureStoreId"	Secure store ID (GUID)
SL_INFO_KEY_SESSION_MACHINE_ID L"SessionMachineId"	Session machine ID (Binary BLOB)

-param peDataType [out, optional]

Type: SLDATATYPE*

A pointer to a value of the SLDATATYPE enumeration that specifies the type of data in the ppbValue buffer.

Value	Meaning
SL_DATA_SZ	UNICODE string
SL_DATA_DWORD	DWORD
SL_DATA_BINARY	Binary blob
SL_DATA_MULTI_SZ	Double null-terminated UNICODE string array

-param pcbValue [out]

Type: UINT*

A pointer to the size, in bytes, of the ppbValue buffer.

-param ppbValue [out]

Type: PBYTE*

If successful, the data is returned in the buffer allocated by SLC.
When finished using the memory, free it by calling the LocalFree function.

-returns

Type: HRESULT WINAPI

If this function succeeds, it return S_OK. Otherwise, it returns an HRESULT error code.

Return code/value	Description
E_INVALIDARG 0x80070057	One or more arguments are not valid.
SL_E_VALUE_NOT_FOUND 0xC004F012	The value for the input key was not found.