Création de votre propre gestionnaire personnalisé

Vous pouvez créer votre propre gestionnaire si vous êtes un administrateur de serveur IIS qui souhaite bénéficier du support RDS par défaut tout en ayant plus de contrôle sur les demandes des utilisateurs et les droits d'accès.

MSDFMAP.Handler implémente l’interface IDataFactoryHandler.

Important

À compter de Windows 8 et Windows Server 2012, les composants serveur RDS ne sont plus inclus dans le système d’exploitation Windows (voir Windows 8 et livre de recettes de compatibilité Windows Server 2012 pour plus de détails). Les composants clients RDS seront supprimés dans une prochaine version de Windows. Évitez d’utiliser cette fonctionnalité dans le nouveau travail de développement et prévoyez de modifier les applications qui utilisent actuellement cette fonctionnalité. Les applications qui utilisent RDS doivent migrer vers wcf Data Service .

Interface IDataFactoryHandler

Cette interface a deux méthodes, GetRecordset et Reconnect. Les deux méthodes nécessitent que la propriété CursorLocation soit définie sur adUseClient.

Les deux méthodes prennent des arguments qui apparaissent après la première virgule dans le mot clé «Handler=». Par exemple, "Handler=progid,arg1,arg2;" passera une chaîne d’argument de "arg1,arg2", et "Handler=progid" transmettra un argument Null.

GetRecordset, méthode

Cette méthode interroge la source de données et crée un objet Recordset à l’aide des arguments fournis. Le recordset de doit être ouvert avec adLockBatchOptimistic et ne doit pas être ouvert de manière asynchrone.

Arguments

conn La chaîne de connexion.

arguments Les arguments pour le gestionnaire.

requête le texte de la commande pour effectuer une requête.

ppRS Pointeur où le jeu d’enregistrements doit être retourné.

Méthode Reconnect

Cette méthode met à jour la source de données. Il crée un nouvel objet Connection et y attache le jeu d'enregistrements donné .

Arguments

conn La chaîne de connexion.

arguments Arguments du gestionnaire.

objet pRS A Recordset.

msdfhdl.idl

Il s’agit de la définition de l’interface pour IDataFactoryHandler qui apparaît dans le fichier msdfhdl.idl.

[  
  uuid(D80DE8B3-0001-11d1-91E6-00C04FBBBFB3),  
  version(1.0)  
]  
library MSDFHDL  
{  
    importlib("stdole32.tlb");  
    importlib("stdole2.tlb");  
  
    // TLib : Microsoft ActiveX Data Objects 2.0 Library  
    // {00000200-0000-0010-8000-00AA006D2EA4}  
    #ifdef IMPLIB  
    importlib("implib\\x86\\release\\ado\\msado15.dll");  
    #else  
    importlib("msado20.dll");  
    #endif  
  
    [  
      odl,  
      uuid(D80DE8B5-0001-11d1-91E6-00C04FBBBFB3),  
      version(1.0)  
    ]  
    interface IDataFactoryHandler : IUnknown  
    {  
HRESULT _stdcall GetRecordset(  
      [in] BSTR conn,  
      [in] BSTR args,  
      [in] BSTR query,  
      [out, retval] _Recordset **ppRS);  
  
// DataFactory will use the ActiveConnection property  
// on the Recordset after calling Reconnect.  
   HRESULT _stdcall Reconnect(  
      [in] BSTR conn,  
      [in] BSTR args,  
      [in] _Recordset *pRS);  
    };  
};  

Voir aussi

Section de connexion des fichiers de personnalisation
Section des journaux de fichiers de personnalisation
Section SQL du fichier de configuration
section UserList de fichier de personnalisation
Personnalisation de DataFactory
Paramètres requis du client
Comprendre le fichier de personnalisation