Función RoGetServerActivatableClasses (roregistrationapi.h)

  • Artículo

Recupera las clases activables registradas para un servidor ejecutable (EXE) determinado, que se registró en el identificador de paquete del proceso de llamada.

Sintaxis

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

Parámetros

[in] serverName

Tipo: HSTRING

Nombre del servidor para el que se van a recuperar los registros de clase. Este nombre de servidor se pasa en la línea de comandos cuando se activa el servidor.

[out] activatableClassIds

Tipo: HSTRING**

Matriz asignada por el destinatario de cadenas de identificador de clase activables que el servidor está registrado para servir. El autor de la llamada debe liberar las cadenas mediante la función WindowsDeleteString . Después, el búfer debe liberarse mediante CoTaskMemFree. El servidor (llamador) es responsable de registrar las factorías de activación para estas clases.

[out] count

Tipo: DWORD*

Recuento de identificadores de clase activables devueltos en la matriz activeableClassIds .

Valor devuelto

Tipo: HRESULT

El método devuelve S_OK si se ejecuta correctamente; de lo contrario, un código de error, incluido lo siguiente.

Código devuelto Descripción
REGDB_E_CLASSNOTREG
 Se proporciona un nombre de servidor vacío, el servidor no está registrado o no hay clases registradas para este servidor.
E_ACCESSDENIED
 El proceso no tiene permisos suficientes para leer el registro de este servidor.

Comentarios

Use la función RoGetServerActivatableClasses para recuperar los nombres de clase a los que se espera que sirva el servidor. Obtenga los detalles de las clases individuales mediante una llamada a la función RoGetActivatableClassRegistration en cada nombre de clase individualmente.

Requisitos

Requisito Value
Cliente mínimo compatible Windows 8 [aplicaciones de escritorio | Aplicaciones para UWP]
Servidor mínimo compatible Windows Server 2012 [aplicaciones de escritorio | Aplicaciones para UWP]
Plataforma de destino Windows
Encabezado roregistrationapi.h
Library Runtimeobject.lib