COleTemplateServer Class

Utilisée pour les serveurs d'édition visuelle OLE, les serveurs Automation et les conteneurs de lien (applications qui prennent en charge les liaisons aux incorporations).

Syntax

class COleTemplateServer : public COleObjectFactory

Members

Public Constructors

Public Methods

Remarks

This class is derived from the class COleObjectFactory; usually, you can use COleTemplateServer directly rather than deriving your own class. COleTemplateServer uses a CDocTemplate object to manage the server documents. Utilisez cette option COleTemplateServer lors de l’implémentation d’un serveur complet, c’est-à-dire un serveur qui peut être exécuté en tant qu’application autonome. Les serveurs complets sont généralement plusieurs applications MDI (Document Interface), bien que les applications SDI (Single Document Interface) soient prises en charge. Un COleTemplateServer objet est nécessaire pour chaque type de document serveur pris en charge par une application ; autrement dit, si votre application serveur prend en charge les feuilles de calcul et les graphiques, vous devez avoir deux COleTemplateServer objets.

COleTemplateServer remplace la OnCreateInstance fonction membre définie par COleObjectFactory. Cette fonction membre est appelée par l’infrastructure pour créer un objet C++ du type approprié.

Pour plus d’informations sur les serveurs, consultez l’article Serveurs : Implémentation d’un serveur.

Inheritance Hierarchy

CObject

CCmdTarget

COleObjectFactory

COleTemplateServer

Requirements

Header: afxdisp.h

COleTemplateServer::COleTemplateServer

Construit un objet COleTemplateServer.

COleTemplateServer();

Remarks

For a brief description of the use of the COleTemplateServer class, see the COleLinkingDoc class overview.

COleTemplateServer::ConnectTemplate

Connects the document template pointed to by pDocTemplate to the underlying COleObjectFactory object.

void ConnectTemplate(
    REFCLSID clsid,
    CDocTemplate* pDocTemplate,
    BOOL bMultiInstance);

Parameters

clsid
Référence à l’ID de classe OLE que le modèle demande.

pDocTemplate
Pointeur vers le modèle de document.

bMultiInstance
Indique si une seule instance de l’application peut prendre en charge plusieurs instanciations. Si la valeur est TRUE, plusieurs instances de l’application sont lancées pour chaque requête pour créer un objet.

Remarks

For more information, see CLSID Key in the Windows SDK.

COleTemplateServer::Unregister

Annule l’inscription du modèle de document associé.

BOOL Unregister();

Return Value

TRUE en cas de réussite, sinon FALSE.

COleTemplateServer::UpdateRegistry

Charge les informations de type de fichier à partir de la chaîne de modèle de document et place ces informations dans le registre système OLE.

void UpdateRegistry(
    OLE_APPTYPE nAppType = OAT_INPLACE_SERVER,
    LPCTSTR* rglpszRegister = NULL,
    LPCTSTR* rglpszOverwrite = NULL,
    BOOL bRegister = TRUE);

Parameters

nAppType
Valeur de l’énumération OLE_APPTYPE, qui est définie dans AFXDISP.H. Il peut avoir l’une des valeurs suivantes :

• OAT_INPLACE_SERVER Server dispose d’une interface utilisateur de serveur complète.

• OAT_SERVER Server prend uniquement en charge l’incorporation.

• OAT_CONTAINER Container prend en charge les liens vers des objets incorporés.

• OAT_DISPATCH_OBJECT Object est IDispatch-capable.

• OAT_DOC_OBJECT_SERVER Server prend en charge l’incorporation et le modèle de composant Objet document.

rglpszRegister
Liste des entrées écrites dans le Registre uniquement si aucune entrée n’existe.

rglpszOverwrite
Liste des entrées écrites dans le Registre, que les entrées précédentes existent ou non.

bRegister
Détermine si la classe doit être inscrite. If bRegister is TRUE, the class is registered with the system registry. Sinon, il annule l’inscription de la classe.

Remarks

The registration information is loaded by means of a call to CDocTemplate::GetDocString. Les sous-chaînes récupérées sont celles identifiées par les index regFileTypeId, regFileTypeNameet fileNewName, comme décrit dans les GetDocString pages de référence.

Si la regFileTypeId sous-chaîne est vide ou si l’appel à GetDocString échouer pour une autre raison, cette fonction échoue et les informations de fichier ne sont pas entrées dans le Registre.

The information in the arguments rglpszRegister and rglpszOverwrite is written to the registry through a call to AfxOleRegisterServerClass. Les informations par défaut, qui sont inscrites lorsque les deux arguments sont NULL, conviennent à la plupart des applications. Pour plus d’informations sur la structure des informations contenues dans ces arguments, consultez AfxOleRegisterServerClass.

Pour plus d'informations, consultez Implementing the IDispatch Interface.

See also

Exemple MFC HIERSVR
COleObjectFactory Class
Hierarchy Chart
COleServerDoc Class
COleServerItem Class