TN064 : modèle de thread apartment dans les contrôles ActiveX

Article
10/12/2023

Remarque

La note technique suivante n'a pas été mise à jour depuis son inclusion initiale dans la documentation en ligne. Par conséquent, certaines procédures et rubriques peuvent être obsolètes ou incorrectes. Pour obtenir les informations les plus récentes, il est recommandé de rechercher l'objet qui vous intéresse dans l'index de la documentation en ligne.

Cette note technique explique comment activer le modèle de thread apartment dans un contrôle ActiveX. Notez que le modèle de thread apartment est pris en charge uniquement dans les versions 4.2 ou ultérieures de Visual C++.

Présentation du thread de modèle d’appartement

Le modèle apartment est une approche de prise en charge d'objets incorporés, tels que les contrôles ActiveX, dans une application conteneur multithread. Bien que l'application puisse avoir plusieurs threads, chaque instance d'un objet incorporé est affectée à une "cloison", qui s'exécute sur un seul thread. En d'autres termes, tous les appels à une instance d'un contrôle se produisent sur le même thread.

Toutefois, différentes instances du même type de contrôle peuvent être affectées à différentes cloisons. Par conséquent, si plusieurs instances d'un contrôle partagent des données en commun (par exemple, les données statiques ou globales), alors l'accès à ces données partagées doit être protégé par un objet de synchronisation, tel qu'une section critique.

Pour plus d’informations sur le modèle de thread d’appartement, consultez Processus et threads dans la référence du programmeur OLE.

Pourquoi prendre en charge le thread de modèle d’appartement

Les contrôles qui prennent en charge le modèle de thread apartment peuvent être utilisés dans des applications conteneur multithread qui prennent également en charge le modèle de cloison. Si vous n'activez pas le modèle de thread apartment, vous limiterez le jeu potentiel de conteneurs dans lesquels votre contrôle peut être utilisé.

Activer le modèle de thread apartment est facile pour la plupart des contrôles, notamment s'ils ont peu ou pas de données partagées.

Protection des données partagées

Si votre contrôle utilise des données partagées, telles qu'une variable membre statique, l'accès à ces données doivent être protégées par une section critique pour éviter que plusieurs threads modifient les données en même temps. Pour installer une section critique à cet effet, déclarez une variable membre statique de la classe CCriticalSection dans la classe de votre contrôle. Utilisez les fonctions membres et Unlock les Lock fonctions de cet objet de section critique partout où votre code accède aux données partagées.

Considérons, par exemple, une classe de contrôle qui doit contenir une chaîne partagée par toutes les instances. Cette chaîne peut être maintenue dans une variable membre statique et être protégée par une section critique. La déclaration de classe du contrôle contient les éléments suivants :

class CSampleCtrl : public COleControl
{
...
    static CString _strShared;
    static CCriticalSection _critSect;
};

L'implémentation de la classe comprend des définitions de ces variables :

int CString CSampleCtrl::_strShared;
CCriticalSection CSampleCtrl::_critSect;

L'accès au membre statique _strShared peut ensuite être protégé par la section critique :

void CSampleCtrl::SomeMethod()
{
    _critSect.Lock();
if (_strShared.Empty())
    _strShared = "<text>";
    _critSect.Unlock();

...
}

Enregistrement d'un contrôle compatible avec le modèle apartment

Les contrôles qui prennent en charge le thread de modèle d’appartement doivent indiquer cette fonctionnalité dans le Registre, en ajoutant la valeur nommée « ThreadingModel » avec la valeur « Apartment » dans leur entrée de Registre d’ID de classe sous la clé InprocServer32 de l’ID \de classe. Pour que cette clé soit automatiquement inscrite pour votre contrôle, passez l’indicateur afxRegApartmentThreading dans le sixième paramètre à AfxOleRegisterControlClass:

BOOL CSampleCtrl::CSampleCtrlFactory::UpdateRegistry(BOOL bRegister)
{
    if (bRegister)
    return AfxOleRegisterControlClass(
    AfxGetInstanceHandle(),
    m_clsid,
    m_lpszProgID,
    IDS_SAMPLE,
    IDB_SAMPLE,
    afxRegApartmentThreading,
    _dwSampleOleMisc,
    _tlid,
    _wVerMajor,
    _wVerMinor);

else
    return AfxOleUnregisterClass(m_clsid,
    m_lpszProgID);

}

Si votre projet de contrôle est généré par ControlWizard dans la version 4.1 de Visual C++ ou une version ultérieure, cet indicateur est déjà présent dans votre code. Aucune modification n'est nécessaire pour stocker le modèle de thread.

Si le projet a été généré par une version précédente de ControlWizard, votre code existant a une valeur booléenne comme sixième paramètre. Si le paramètre existant a la valeur TRUE, remplacez-le par afxRegInsertable | afxRegApartmentThreading. Si le paramètre existant a la valeur FALSE, remplacez-le par afxRegApartmentThreading.

Si votre contrôle ne respecte pas les règles de thread de modèle d’appartement, vous ne devez pas passer afxRegApartmentThreading dans ce paramètre.

Voir aussi

Notes techniques par numéro
Notes techniques par catégorie

Partager via