Função RoGetServerActivatableClasses (roregistrationapi.h)

Recupera as classes ativáveis registradas para um determinado servidor EXE (executável), que foi registrado na ID do pacote do processo de chamada.

Sintaxe

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

Parâmetros

[in] serverName

Tipo: HSTRING

O nome do servidor para o qual recuperar registros de classe. Esse nome de servidor é passado na linha de comando quando o servidor é ativado.

[out] activatableClassIds

Tipo: HSTRING**

Uma matriz alocada por callee de cadeias de caracteres de ID de classe ativáveis que o servidor está registrado para atender. As cadeias de caracteres devem ser liberadas pelo chamador usando a função WindowsDeleteString . Em seguida, o buffer deve ser liberado usando CoTaskMemFree. O servidor (chamador) é responsável por registrar as fábricas de ativação dessas classes.

[out] count

Tipo: DWORD*

A contagem de IDs de classe ativáveis retornadas na matriz activatableClassIds .

Retornar valor

Tipo: HRESULT

O método retorna S_OK com êxito, caso contrário, um código de erro, incluindo o seguinte.

Código de retorno	Descrição
REGDB_E_CLASSNOTREG	Um nome de servidor vazio é fornecido, o servidor não está registrado ou nenhuma classe é registrada para esse servidor.
E_ACCESSDENIED	O processo não tem permissões suficientes para ler o registro deste servidor.

Comentários

Use a função RoGetServerActivatableClasses para recuperar os nomes de classe que o servidor deve servir. Obtenha os detalhes sobre as classes individuais chamando a função RoGetActivatableClassRegistration em cada nome de classe individualmente.

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Windows 8 [aplicativos da área de trabalho | Aplicativos UWP]
Servidor mínimo com suporte	Windows Server 2012 [aplicativos da área de trabalho | Aplicativos UWP]
Plataforma de Destino	Windows
Cabeçalho	roregistrationapi.h
Biblioteca	Runtimeobject.lib