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 */;
Inhaltsverzeichnis
Eigenschaften
| Typ | Sichtbarkeit | Quelle | Unit | Übergeordnet | 
|---|---|---|---|---|
| function | protected | REST.Backend.EMSServices.pas REST.Backend.EMSServices.hpp | REST.Backend.EMSServices | TEMSUsersAPI | 
Beschreibung
Fragt den EMS-Server nach den Daten eines Benutzers mit dem angegebenen Benutzernamen ab und gibt True zurück, wenn ein Benutzer mit dem angegebenen Benutzernamen auf dem EMS-Server vorhanden ist; ansonsten wird False zurückgegeben.
Stellen Sie für die weitere Behandlung der empfangenen Informationen entweder die folgenden Instanzen oder die folgende Prozedur bereit:
- Eine Instanz von TBackendEntityValue (AUser) und eine Instanz von TJSONArray (AJSON). QueryUserName füllt das angegebene Objekt mit den empfangenen Benutzerdaten.
- Eine Prozedur mit dem Typ TFindObjectProc (AProc). QueryUserName ruft Ihre Prozedur auf und stellt die erhaltenen Benutzerdaten sowohl als Instanz von TBackendEntityValue (erstes Argument) als auch als Instanz von TJSONObject (zweites Argument) bereit.
Exceptions
| Exception | Meldung | Beschreibung | 
|---|---|---|
| MasterSecret erforderlich | Der Authentifizierungstyp ist TAuthentication.MasterSecret, und die Eigenschaft MasterSecret der Verbindungsinformationen des zugrunde liegenden EMS-Backend-Dienstes ist ein leerer String. | |
| Ein Benutzer erwartet | Der EMS-Server hat mehr als einen Benutzer für den angegebenen Benutzernamen zurückgegeben. | |
| Sitzungs-Token erforderlich | Der Authentifizierungstyp ist TAuthentication.Session, und Sie haben sich nicht angemeldet. |