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