JetEnableMultiInstance fonction)

S’applique à : Windows | Windows Serveurs

JetEnableMultiInstance fonction)

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 la modification du 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 seulement 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 seulement 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 ne sont pas autorisés. Cette erreur peut être retournée par JetEnableMultiInstance uniquement lorsque vous définissez JET_paramIndexTuplesLengthMin, JET_paramIndexTuplesLengthMaxou JET_paramIndexTuplesToIndexMax sur une valeur non conforme.

Windows XP : cette valeur de retour est introduite dans Windows XP.

JET_errInvalidPath

Le chemin d’accès au système de fichiers spécifié n’est pas valide. Cette erreur peut être retournée par JetEnableMultiInstance uniquement lors de la définition des paramètres système qui représentent les chemins d’accès du système de fichiers. Par exemple, JET_paramSystemPath pouvez retourner cette erreur.

JET_errRunningInOneInstanceMode

l’opération a échoué, car elle n’est pas conforme lorsque le moteur de base de données fonctionne en mode d’instance unique (mode de compatibilité Windows 2000).

JET_errSystemParamsAlreadySet

JetEnableMultiInstance a échoué, car le moteur est déjà en mode multi-instance.

Remarque Cela se produit même si aucun paramètre système n’est spécifié.

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

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

Remarques

Cette fonction doit être utilisée uniquement si l’application doit configurer de manière atomique un ensemble donné de paramètres système 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.

Configuration requise

Condition requise Valeur

Client

requiert Windows Vista ou Windows XP.

Serveur

requiert Windows server 2008 ou Windows server 2003.

En-tête

Déclaré dans esent. h.

Bibliothèque

Utilisez ESENT. lib.

DLL

Requiert ESENT.dll.

Unicode

Implémenté en tant que JetEnableMultiInstanceW (Unicode) et JetEnableMultiInstanceA (ANSI).

Voir aussi

JET_ERR
JET_SETSYSPARAM
JetCreateInstance
JetInit
JetSetSystemParameter