Fonction JetEnableMultiInstance

S’applique à : Windows | Windows Server

Fonction JetEnableMultiInstance

La fonction JetEnableMultiInstance configure le moteur de base de données pour une utilisation avec plusieurs instances dans le même processus. Un tableau facultatif de paramètres système globaux est disponible pour le premier appelant, ce qui permet de passer au mode multi-instance.

Windows XP : JetEnableMultiInstance est introduit dans Windows XP.

    JET_ERR JET_API JetEnableMultiInstance(
      __in_opt      JET_SETSYSPARAM* psetsysparam,
      __in_opt      unsigned long csetsysparam,
      __out_opt     unsigned long* pcsetsucceed
    );

Paramètres

psetsysparam

Tableau de paramètres système globaux à définir si et uniquement si le moteur passe en mode multi-instance à la suite de cet appel. Si csetsysparam est égal à zéro, psetsysparam est ignoré.

csetsysparam

Nombre d’éléments pour le tableau de paramètres globaux à définir si et uniquement si le moteur passe en mode multi-instance à la suite de cet appel. Si csetsysparam est égal à zéro, psetsysparam est ignoré.

pcsetsucceed

Pointeur vers le nombre de paramètres système globaux qui ont été correctement configurés à la suite de cet appel.

Valeur renvoyée

Cette fonction retourne le type de données JET_ERR avec l’un des codes de retour suivants. Pour plus d’informations sur les erreurs ESE possibles, consultez Erreurs du moteur de stockage extensible et Paramètres de gestion des erreurs.

Code de retour	Description
JET_errSuccess	L’opération s’est terminée avec succès.
JET_errIndexTuplesInvalidLimits	Les paramètres d’index de tuple spécifiés n’étaient pas autorisés. Cette erreur peut être retournée par JetEnableMultiInstance uniquement lorsque JET_paramIndexTuplesLengthMin, JET_paramIndexTuplesLengthMax ou JET_paramIndexTuplesToIndexMax sur une valeur non conforme. Windows XP : Cette valeur de retour est introduite dans Windows XP.
JET_errInvalidPath	Le chemin du système de fichiers spécifié n’était pas valide. Cette erreur peut être retournée par JetEnableMultiInstance uniquement lors de la définition de paramètres système qui représentent des chemins d’accès au système de fichiers. Par exemple, JET_paramSystemPath pouvez retourner cette erreur.
JET_errRunningInOneInstanceMode	L’opération a échoué, car elle est illégale lorsque le moteur de base de données fonctionne en mode instance unique (mode de compatibilité Windows 2000).
JET_errSystemParamsAlreadySet	Échec de JetEnableMultiInstance, car le moteur est déjà en mode multi-instance. Note Cela se produit même si aucun paramètre système n’est spécifié.

Si cette fonction réussit, le moteur de base de données est configuré pour s’exécuter en mode multi-instance. Le moteur a également été correctement configuré avec la liste facultative des paramètres système globaux.

Si cette fonction échoue, le moteur de base de données reste en mode actuel. Si pcsetsucceed est différent de zéro, ce nombre de paramètres système reste défini.

Notes

Cette fonction ne doit être utilisée que si l’application doit configurer un ensemble donné de paramètres système de manière atomique lors de la configuration du moteur de base de données pour une utilisation dans un scénario multi-utilisateur dans le même processus. Si une autre méthode de synchronisation est disponible, il est préférable d’appeler JetCreateInstance et JetSetSystemParameter séparément.

Spécifications

Condition requise	Valeur
Client	Nécessite Windows Vista ou Windows XP.
Serveur	Nécessite Windows Server 2008 ou Windows Server 2003.
En-tête	Déclaré dans Esent.h.
Bibliothèque	Utilisez ESENT.lib.
DLL	Nécessite ESENT.dll.
Unicode	Implémenté en tant que JetEnableMultiInstanceW (Unicode) et JetEnableMultiInstanceA (ANSI).

Voir aussi

JET_ERR
JET_SETSYSPARAM
JetCreateInstance
JetInit
JetSetSystemParameter