onUserLogonBegin - zdarzenie objektu PmRoot

Opis:

Zdarzenie jest wywołane przy próbie zalogowania użytkownika do działającej aplikacji po tym, kiedy wprowadził nazwę oraz hasło do logowania. PROMOTIC wykona weryfikację ważności w liście użytkowników i następnie wywoła omawiane zdarzenie z parametrami w obiekcie pEvent z góry ustawionymi według tego, czy nazwa oraz hasło użytkownika zostały znalezione w liście czy też nie. W ten sposób można zezwolić lub zakazać zalogowanie użytkownika także i według innych kryteriów, niż są zawarte w standardowym opracowaniu logowania. Można w ten sposób wytworzyć na przykład własne listy użytkowników zapisane w pliku INI z zaszyfrowanymi hasłami (Pm.IniFileRead, Pm.IniFileWrite, Pm.EncryptText oraz Pm.DecryptText).

Parametry:

pMe	(Object) Odniesienie do PROMOTIC obiektu, w którym doszło do danego zdarzenia.
pEvent	(Object) Odniesienie do obiektu zawierającego ściślejsze informacje o danym zdarzeniu. pEvent.User - (Object) Obiekt User, który przedstawia zalogowanego użytkownika. pEvent.UserId - (String) Identyfikator zalogowanego użytkownika. Wartość tego parametru jest wstępnie ustawiana w przypadku, że nazwa wprowadzona przez użytkownika jest odnaleziona w liście użytkowników. pEvent.Name - (String) Nazwa zalogowanego użytkownika. Wartość tego parametru jest wstępnie ustawiona na nazwę wprowadzoną przez użytkownika. pEvent.Password - (String) Hasło zalogowanego użytkownika. Wartość tego parametru jest wstępnie ustawiona na hasło wprowadzone przez użytkownika. pEvent.Error - (Long) Określa, która informacja nie jest poprawna. Wg wartości bieżącej zostanie po zakończeniu tego zdarzenia ewentualnie wyświetlona uwaga z tekstem, czy jest niepoprawna nazwa użytkownika czy też hasło. Wartość można zmienić i w ten sposób można wpłynąć na wyświetlaną uwagę. 0 - Nazwa użytkownika i hasło są poprawne. 1 - Nazwa użytkownika nie jest poprawna. 2 - Hasło nie jest poprawne. pEvent.Enabled - (Boolean) Zezwolenie/zakaz zalogowannia danego użytkownika. Wartość tego parametru jest wstępnie ustawiona na podstawie porównania zgodności wprowadzonych danych z listą użytkowników. Jeżeli wartością właściwości jest true, wtedy jest dozwolone zalogowanie użytkownika. W innym przypadku wartością właściwości jest false. W ten sposób można na przykład zezwolić (zakazać) zalogowanie użytkownika z listy użytkowników, który w zwyczjnym przypadku nie mógł (mógł) by się zalogować. pEvent.Level - (Integer) (przestarzałe) Poziom danego użytkownika. Wartość tego parametru jest wstępnie ustawiona na podstawie porównania zgodności wprowadzonych danych z listą użytkowników. Poziom zalogowanego użytkownika można w ten sposób ustawić lub zmienić (nie musi być ustawiane w liście użytkowników).

pMe

(Object) Odniesienie do PROMOTIC obiektu, w którym doszło do danego zdarzenia.

pEvent

(Object) Odniesienie do obiektu zawierającego ściślejsze informacje o danym zdarzeniu.

pEvent.User - (Object) Obiekt User, który przedstawia zalogowanego użytkownika.

pEvent.UserId - (String) Identyfikator zalogowanego użytkownika. Wartość tego parametru jest wstępnie ustawiana w przypadku, że nazwa wprowadzona przez użytkownika jest odnaleziona w liście użytkowników.

pEvent.Name - (String) Nazwa zalogowanego użytkownika. Wartość tego parametru jest wstępnie ustawiona na nazwę wprowadzoną przez użytkownika.

pEvent.Password - (String) Hasło zalogowanego użytkownika. Wartość tego parametru jest wstępnie ustawiona na hasło wprowadzone przez użytkownika.

pEvent.Error - (Long) Określa, która informacja nie jest poprawna. Wg wartości bieżącej zostanie po zakończeniu tego zdarzenia ewentualnie wyświetlona uwaga z tekstem, czy jest niepoprawna nazwa użytkownika czy też hasło. Wartość można zmienić i w ten sposób można wpłynąć na wyświetlaną uwagę.

0 - Nazwa użytkownika i hasło są poprawne.

1 - Nazwa użytkownika nie jest poprawna.

2 - Hasło nie jest poprawne.

pEvent.Enabled - (Boolean) Zezwolenie/zakaz zalogowannia danego użytkownika. Wartość tego parametru jest wstępnie ustawiona na podstawie porównania zgodności wprowadzonych danych z listą użytkowników. Jeżeli wartością właściwości jest true, wtedy jest dozwolone zalogowanie użytkownika. W innym przypadku wartością właściwości jest false. W ten sposób można na przykład zezwolić (zakazać) zalogowanie użytkownika z listy użytkowników, który w zwyczjnym przypadku nie mógł (mógł) by się zalogować.

pEvent.Level - (Integer) (przestarzałe) Poziom danego użytkownika. Wartość tego parametru jest wstępnie ustawiona na podstawie porównania zgodności wprowadzonych danych z listą użytkowników. Poziom zalogowanego użytkownika można w ten sposób ustawić lub zmienić (nie musi być ustawiane w liście użytkowników).

Notatka:

Zdarzenie jest wywołane dla każdego użytkownika (lokalnego i sieciowego). Szczegółowe informacje dotyczące użytkownika (obiekt User) są dostępne w parametrze pEvent.User.

Patrz również:

- onUserLogonEnd

- onUserLogoff

- Użytkownicy

- Administracja użytkowników, uprawnień i system logowania

- User

- Właściwości i metody Pm do administracji użytkowników

Przykład1:

Jeżeli kod ma być wykonywany tylko dla użytkowników lokalnych, wtedy można wtedy testować wartość właściwości User.Type.

VBScriptWybierz oraz skopiuj do schowka


If pEvent.User.Type = 1 Then
  '... Kod wykonywany tylko dla użytkowników lokalnych
End If

Przykład2:

Odmowa zalogowania nowego użytkownika sieciowego jeżeli taki użytkownik o zgodnym Id jest już zalogowany.

VBScriptWybierz oraz skopiuj do schowka


Dim i, aUsers, nUsers
aUsers = Pm.GetUserInfo("what:loguserarray;type:net;")
nUsers = UBound(aUsers)

For i = 0 To nUsers
  If aUsers(i).Id = pEvent.UserId Then
    pEvent.Enabled = 0
  End If
Next