Cette instruction permet la recherche dans un annuaire LDAP.
[Srldapbs|Srldaplv|Srldaptr] DN_entrée_demarrage Filter Critéres_de_recherche With
& VAR0 As "Attribut0",
& VAR1 As "Attribut1"
& VAR2 As "Attribut2",
& VAR3 As "Attribut3",
& VAR4 As "Attribut4",
...
& [Sized V0[,V1]]
& [Using abrev]
Elément | Type | Description |
DN_entrée_demarrage | Variable de type Char Clbfile | DN décrivant l'entrée de démarrage de la recherche. |
Critéres_de_recherche | Variable de type Char Clbfile | Critère de recherche dans la syntaxe LDAP |
VAR0,VAR1,... | Variable de type Char Clbfile ou Blbfile | Variables préalablement déclarées dans le code du traitement. |
V0,V1 | Constante de type numérique | Nombre limite d'entrées, temps limite en seconde |
abrev | Constante de type alphanumérique | Classe de référence |
Comme le permet le protocole LDAP, trois types de recherche sont possibles : base, level et tree. A chaque type de recherche correspond respectivement un mot clé : Srldapbs, Srldaplv et Srldaptr.
VAR0, VAR1… : sont des variables préalablement déclarées dans le code du traitement. Elles peuvent être du type Char ou Clbfile, Blbfile suivant qu’elles doivent recevoir des valeurs binaires ou des chaînes de caractères. Une variable Clbfile permet de récupérer des champs binaires sous forme de chaîne de caractères « \0x20\0x15\0x02... », par exemple, pour permettre notamment de réinjecter cette chaine dans un critère de recherche. Attention, une chaîne récupérée dans une variable Clbfile, sera automatiquement convertie en binaire. Les variables peuvent être également dimensionnées afin de recevoir des valeurs d’attributs multivalués.
V0, V1 : La recherche peut être limitée en taille et en temps. V0 indique le nombre d'entrées, et V1 le temps en seconde. Mettre 0, si aucune limite n'est fixée.
Si aucune entrée n’est retournée par la recherche, fstat retourne la valeur 5 sinon, il retourne la valeur 0.
Si cette commande de recherche doit rendre plusieurs entrées, les entrées suivantes peuvent être lues avec la commande Nxldap.