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.

Syntax

HRESULT RoGetServerActivatableClasses(
  [in]  HSTRING serverName,
  [out] HSTRING **activatableClassIds,
  [out] DWORD   *count
);

Parameters

[in] serverName

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.

[out] activatableClassIds

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.

[out] count

Type: DWORD*

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

Return value

Type: HRESULT

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

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.

Requirements