Partager via


AfxOleRegisterServerClass

Cette fonction permet de stocker votre serveur dans le Registre système OLE.

BOOL AFXAPI AfxOleRegisterServerClass( 
   REFCLSID clsid, 
   LPCTSTR lpszClassName, 
   LPCTSTR lpszShortTypeName, 
   LPCTSTR lpszLongTypeName, 
   OLE_APPTYPE nAppType = OAT_SERVER, 
   LPCTSTR* rglpszRegister = NULL, 
   LPCTSTR* rglpszOverwrite = NULL  
);

Paramètres

  • clsid
    Référence à l'ID de la classe OLE du serveur.

  • lpszClassName
    Pointeur vers une chaîne contenant le nom de classe les objets du serveur.

  • lpszShortTypeName
    Pointeur vers une chaîne contenant le nom court du type d'objet serveur, par exemple « graphique ».

  • lpszLongTypeName
    Pointeur vers une chaîne contenant le nom long du type d'objet serveur, par exemple « graphique de Microsoft Excel 5,0 ».

  • nAppType
    Une valeur, extraite de l'énumération OLE_APPTYPE, en spécifiant le type d'application OLE. Les valeurs possibles sont les suivantes:

    • le serveur deOAT_INPLACE_SERVERà l'interface utilisateur du serveur tout entier.

    • prise en charge de serveur deOAT_SERVERincorporant uniquement.

    • liens de supports conteneur de OAT_CONTAINERvers des embeddings.

    • OAT_DISPATCH_OBJECT   IDispatch- objet en mesure.

  • rglpszRegister
    Tableau de pointeurs vers les chaînes représentant des clés et les valeurs à ajouter au Registre système OLE si aucune valeur existante pour les clés n'est trouvée.

  • rglpszOverwrite
    Tableau de pointeurs vers les chaînes représentant des clés et les valeurs à ajouter au Registre système OLE si le registre contient des valeurs existantes des clés données.

Valeur de retour

Une valeur différente de zéro si la classe du serveur est correctement stockée ; sinon 0.

Notes

La plupart des applications peuvent utiliser COleTemplateServer::Register pour stocker les types de documents d'application. Si le format de le registre système de votre application ne correspond pas au modèle standard, vous pouvez utiliser AfxOleRegisterServerClass pour un meilleur contrôle.

Le Registre se compose d'un ensemble de clés et valeurs. Les arguments rglpszRegister et rglpszOverwrite sont des tableaux de pointeurs vers les chaînes, chacune comprenant une colonne clé et de valeurs séparées par un caractère de NULL ('\0'). Chacune de ces chaînes peut avoir des paramètres substituables dont les emplacements sont marqués par les séquences de caractères %1 via %5.

Les symboles sont remplis comme suit :

Symbole

Valeur

%1

ID de classe, exprimée sous forme de chaînes

%2

Nom de classe

%3

Chemin d'accès au fichier exécutable

%4

Nom court de type

%5

Nom de type long

Configuration requise

En-tête : <afxdisp.h>

Voir aussi

Référence

COleTemplateServer::UpdateRegistry

Concepts

macro MFC et Globals