REST.Backend.EMSServices.TEMSUsersAPI.QueryUserName
Delphi
function QueryUserName(const AUserName: string; AProc: TFindObjectProc)
function QueryUserName(const AUserName: string;
out AUser: TBackendEntityValue; const AJSON: TJSONArray)
C++
bool __fastcall QueryUserName(const System::UnicodeString AUserName, Rest::Backend::Servicetypes::_di_TFindObjectProc AProc)/* overload */;
bool __fastcall QueryUserName(const System::UnicodeString AUserName, /* out */ Rest::Backend::Metatypes::TBackendEntityValue &AUser, System::Json::TJSONArray* const AJSON)/* overload */;
Propriétés
| Type | Visibilité | Source | Unité | Parent |
|---|---|---|---|---|
| function | protected | REST.Backend.EMSServices.pas REST.Backend.EMSServices.hpp |
REST.Backend.EMSServices | TEMSUsersAPI |
Description
Demande au serveur EMS les données d'un utilisateur ayant le nom d'utilisateur spécifié et renvoie True si un utilisateur ayant le nom d'utilisateur spécifié existe dans le serveur EMS ou False dans le cas contraire.
Pour gérer les informations reçues, vous devez fournir l'un des éléments suivants :
- Une instance de TBackendEntityValue (
AUser) et une instance de TJSONArray (AJSON). QueryUserName remplit les deux objets avec les données d'utilisateur reçues. - Une procédure de type TFindObjectProc (
AProc). QueryUserName appelle votre procédure et fournit les données d'utilisateur reçues à la fois en tant qu'instance de TBackendEntityValue (premier argument) et qu'instance de TJSONObject (second argument).
Exceptions
| Exception | Message | Description |
|---|---|---|
|
MasterSecret requis |
Le type d'authentification a la valeur TAuthentication.MasterSecret, et la propriété MasterSecret des informations de connexion du service backend EMS sous-jacent est une chaîne vide. | |
|
Un utilisateur attendu |
Le serveur EMS a renvoyé plusieurs utilisateurs pour le nom d'utilisateur spécifié. | |
|
Token de session requis |
Le type d'authentification a la valeur TAuthentication.Session, et vous ne vous êtes pas connecté. |