GetVerifyResult
Diese Methode liefert ein detailliertes Ergebnis der Verifizierung der Authentifizierungsdaten. Die interne Standardverifizierung erfolgt im Server beim Empfang der Associate-Request-Daten (AARQ-Telegramm) und beim Client beim Empfang der Associate-Response-Daten (AARE-Telegramm). Beim GetVerifyResult-Rückgabeparameterwert TRUE darf die IEC 61850 Server- oder Client-Applikation zum bestimmten Zeitpunkt den Authentifizierungsstatus selbst kontrollieren oder verändern aber nur, wenn in den Kommunikationsanforderungen der beiden Kommunikationspartner die Authentifizierung (authentication-functional-unit) aktiviert wurde.
Eine Verbindung, die vom Server voraussichtlich akzeptiert wird, kann mit Hilfe der Reject-Methode nachträglich abgewiesen werden. Eine Verbindung, die vom Server voraussichtlich abgewiesen wird, kann mit Hilfe der Accept-Methode nachträglich akzeptiert werden. In einer Server-Applikation dürfen die Methoden: Accept oder Reject aber nur innerhalb der Implementierung der OnAssociateInd Ereignisbehandlungsroutine aufgerufen werden. Nur zu diesem Zeitpunkt kann die Applikation den Authentifizierungsprozess noch selbst kontrollieren.
Im Mutual-Authentifizierungsmode kann eine Client-Applikation zum bestimmten Zeitpunkt ebenfalls den Authentifizierungsstatus selbst kontrollieren. Eine vom Client voraussichtlich akzeptierte Verbindung kann mit Hilfe der Reject-Methode abgewiesen werden. Eine Verbindung, die vom Client voraussichtlich abgewiesen wird, kann mit Hilfe der Accept-Methode nachträglich akzeptiert werden. In einer Client-Applikation dürfen die Methoden Accept oder Reject nur innerhalb der Implementierung der OnAssociateCnf Ereignisbehandlungsroutine aufgerufen werden. Eine vom Server bereits abgewiesene Verbindung kann vom Client nicht mehr nachträglich akzeptiert werden.
METHOD GetVerifyResult : BOOL
VAR_OUTPUT
bAccepted : BOOL;
eType : E_AcseAuthentication;
sMechanismName : STRING;
sPassword : STRING;
sRespondingPass : STRING;
eResult : E_ACSE_AareResult;
eDiagnostic : E_ACSE_AareDiagnostic;
eAbrtDiagnostic : E_ACSE_AbrtDiagnostic;
END_VARbAccepted: Generelles Ergebnis der Verifizierung der Authentifizierungsdaten. TRUE => Verbindung wird akzeptiert und aufrechterhalten, FALSE => Verbindung wird abgewiesen und geschlossen. Dieser Parameter wird auch TRUE sein, wenn bei beiden Kommunikationspartnern keine Authentifizierung konfiguriert/aktiviert wurde.
eType: Der verwendete/konfigurierte Authentifizierungsmodus vom Typ E_AcseAuthentication. Unilateral (Standard) oder mutual.
sMechanismName: Name des Authentifizierungsmechanismus. Client => gesendeter Name, Server => empfangener Name (Standard: ‘2.2.3.1‘).
sPassword: Authentifizierungspasswort im Klartext. Client => gesendetes Passwort, Server => empfangenes Passwort.
sRespondingPass: Passwort im Klartext, gesendet als Antwort beim mutualen Authentifizierungstyp.
eResult: Ergebnisparameter im Association-Response-Befehl vom Typ E_ACSE_AareResult. Ergebnisparameter, welchen der Server als Antwort zum Client senden wird, oder den der Client als Antwort vom Server bereits empfangen hat (im ACSE-AARE Telegramm).
eDiagnostic: Diagnosedaten zum Association-Response-Befehl vom Typ E_ACSE_AareDiagnostic. Zusätzliche Information, welche der Server als Antwort zum Client senden wird, oder die der Client als Antwort vom Server bereits empfangen hat (im ACSE-AARE Telegramm).
eAbrtDiagnostic: Diagnosedaten vom Typ E_ACSE_AbrtDiagnostic, die im Falle einer abgewiesenen Verbindung im Association-Abort-Befehl gesendet werden.
Rückgabeparameter: TRUE => Erfolg, die Client-/Server-Applikation darf den Authentifizierungsstatus kontrollieren oder verändern. FALSE => Fehler (z. B. Befehl nicht zulässig oder im aktuellen Zustand nicht erlaubt).