Fonction JetGetInstanceInfo
S’applique à : Windows | Windows Server
Fonction JetGetInstanceInfo
La fonction JetGetInstanceInfo récupère des informations sur les instances en cours d’exécution.
Windows XP : JetGetInstanceInfo est introduit dans Windows XP.
JET_ERR JET_API JetGetInstanceInfo(
__out unsigned long* pcInstanceInfo,
__out JET_INSTANCE_INFO** paInstanceInfo
);
Paramètres
pcInstanceInfo
Pointeur vers une mémoire tampon qui recevra le nombre d’éléments stockés dans paInstanceInfo.
paInstanceInfo
Pointeur vers une mémoire tampon qui recevra l’adresse du premier élément d’un tableau de structures.
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_errInvalidParameter |
L’un des paramètres fournis contenait une valeur inattendue ou contenait une valeur qui n’était pas logique lorsqu’elle était combinée à la valeur d’un autre paramètre. Cette erreur sera retournée par JetGetInstanceInfo dans les cas suivants :
|
JET_errOutOfMemory |
La mémoire est insuffisante pour traiter la demande. |
Notes
Le moteur de base de données alloue un tableau de structures JET_INSTANCE_INFO . L’appelant est responsable de libérer cette mémoire avec JetFreeBuffer.
S’il n’y a aucune instance active, JetGetInstanceInfo retourne JET_errSuccess et pcInstanceInfo reçoit la valeur 0.
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 JetGetInstanceInfoW (Unicode) et JetGetInstanceInfoA (ANSI). |