La méthode openMatcherEX() combine les méthodes attach() et openMatcher() dans une seule méthode.
La valeur renvoyée est le chemin de communication (handle) vers le serveur. Le chemin de communication doit être utilisé dans les appels API ultérieurs pour échanger des données avec le serveur. (Si la valeur renvoyée est 0, voir « Valeurs renvoyées » ci-dessous.)
Syntaxe
public int openMatcherEx(char systemID,
java.lang.String serverName,
int retCode[]);Paramètres
|
Nom |
Type |
Utilisation |
Longueur |
Description |
|---|---|---|---|---|
|
systemID |
caractère |
Entrée |
1 |
ID système du serveur demandé. |
|
serverName |
chaîne |
Entrée |
1-8 |
Nom du serveur demandé. |
|
retCode |
int[ ] |
Sortie |
4 |
Code d'erreur indiquant le statut de l'appel de la méthode. |
Valeurs renvoyées
La valeur retournée 0 indique que la tentative de connexion à un serveur Director a échoué, et le code retCode indique l'erreur spécifique. Pour la description du contenu du paramètre retCode, reportez-vous à Valeurs renvoyées.
Exemple
TrilTGenClient testClient = new TrilTGenClient();
// Return code and handle
int[] retCode = new int[1];
int handle = 0;
// System and Server ID for attach()
char systemID;
String serverName;
systemID = 'G';
serverName = "RMatcher";
// Attach and initialize the session using openMatcherEx()
handle = testClient.openMatcherEx(systemID, serverName, retCode);
if (retCode[0] == 0) {
// Perform relevant processing
// Close the matcher server and release using closeMatcherEx()
testClient.closeMatcherEx(handle, retCode);
}