nf-roregistrationapi-rogetserveractivatableclasses.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:roregistrationapi.RoGetServerActivatableClasses	RoGetServerActivatableClasses function (roregistrationapi.h)	Retrieves the activatable classes that are registered for a given executable (EXE) server, which was registered under the package ID of the calling process.	RoGetServerActivatableClasses RoGetServerActivatableClasses function [Windows Runtime] roregistrationapi/RoGetServerActivatableClasses winrt.rogetserveractivatableclasses	winrt\rogetserveractivatableclasses.htm	WinRT	845AC938-DE04-4151-8500-B8657234201C	12/05/2018	RoGetServerActivatableClasses, RoGetServerActivatableClasses function [Windows Runtime], roregistrationapi/RoGetServerActivatableClasses, winrt.rogetserveractivatableclasses	roregistrationapi.h		Windows	Windows 8 [desktop apps \| UWP apps]	Windows Server 2012 [desktop apps \| UWP apps]										Runtimeobject.lib			Windows			19H1	RoGetServerActivatableClasses roregistrationapi/RoGetServerActivatableClasses	c++	APIRef kbSyntax	DllExport	runtimeobject.lib runtimeobject.dll API-MS-Win-Core-WinRT-registration-l1-1-0.dll ComBase.dll	RoGetServerActivatableClasses

RoGetServerActivatableClasses function

-description

Retrieves the activatable classes that are registered for a given executable (EXE) server, which was registered under the package ID of the calling process.

-parameters

-param serverName [in]

Type: HSTRING

The name of the server to retrieve class registrations for. This server name is passed on the command line when the server is activated.

-param activatableClassIds [out]

Type: HSTRING**

A callee-allocated array of activatable class ID strings which the server is registered to serve. The strings must be released by the caller using the WindowsDeleteString function. The buffer must then be released using CoTaskMemFree. The server (caller) is responsible for registering the activation factories for these classes.

-param count [out]

Type: DWORD*

The count of activatable class IDs returned in the activatableClassIds array.

-returns

Type: HRESULT

The method returns S_OK on success, otherwise an error code, including the following.

Return code	Description
REGDB_E_CLASSNOTREG	An empty server name is provided, the server is not registered, or no classes are registered for this server.
E_ACCESSDENIED	The process does not have sufficient permissions to read this server’s registration.

-remarks

Use the RoGetServerActivatableClasses function to retrieve the class names that the server is expected to serve. Get the details on the individual classes by calling the RoGetActivatableClassRegistration function on each class name individually.