Partager via


Fonction RoGetServerActivatableClasses (roregistrationapi.h)

Récupère les classes activables inscrites pour un serveur exécutable (EXE) donné, qui a été inscrit sous l’ID de package du processus appelant.

Syntaxe

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

Paramètres

[in] serverName

Type : HSTRING

Nom du serveur pour lequel récupérer les inscriptions de classe. Ce nom de serveur est transmis sur la ligne de commande lorsque le serveur est activé.

[out] activatableClassIds

Type : HSTRING**

Tableau alloué par appel de chaînes d’ID de classe activables que le serveur est inscrit pour servir. Les chaînes doivent être libérées par l’appelant à l’aide de la fonction WindowsDeleteString . La mémoire tampon doit ensuite être libérée à l’aide de CoTaskMemFree. Le serveur (appelant) est responsable de l’inscription des fabriques d’activation pour ces classes.

[out] count

Type : DWORD*

Nombre d’ID de classe activable retournés dans le tableau activateableClassIds .

Valeur retournée

Type : HRESULT

La méthode retourne S_OK en cas de réussite, sinon un code d’erreur, y compris les éléments suivants.

Code de retour Description
REGDB_E_CLASSNOTREG
Un nom de serveur vide est fourni, le serveur n’est pas inscrit ou aucune classe n’est inscrite pour ce serveur.
E_ACCESSDENIED
Le processus ne dispose pas des autorisations suffisantes pour lire l’inscription de ce serveur.

Remarques

Utilisez la fonction RoGetServerActivatableClasses pour récupérer les noms de classes que le serveur est censé servir. Obtenez les détails des classes individuelles en appelant la fonction RoGetActivatableClassRegistration sur chaque nom de classe individuellement.

Configuration requise

Condition requise Valeur
Client minimal pris en charge Windows 8 [applications de bureau | Applications UWP]
Serveur minimal pris en charge Windows Server 2012 [applications de bureau | Applications UWP]
Plateforme cible Windows
En-tête roregistrationapi.h
Bibliothèque Runtimeobject.lib