Fonction RoGetServerActivatableClasses (roregistrationapi.h)

Article
03/06/2024

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

Share via