IF_VerifyCertCallback.VerifyCertCallback (Metodo)

Panoramica

Tipo:

Metodo

Disponibile a partire da:

V2.2.6.0

Descrizione

Se l'interfaccia IF_VerifyCertCallback è assegnata alle impostazioni TLS dei metodi corrispondenti di FB_TcpClient2 o FB_TcpServer2, il metodo di interfaccia VerifyCertCallback viene chiamato dal sistema dopo verifica del certificato ricevuto dal peer.

Il valore restituito del metodo indica il risultato della verifica. Sono disponibili due opzioni:

  • Se si assegna il valore dell'ingresso verifyResult al valore restituito, si conferma il risultato della verifica del sistema.

  • Per ignorare il risultato, è possibile restituire un valore alternativo. Questo influenza il risultato del processo di connessione e di accettazione.

NOTA: Se non si aggiunge alcuna implementazione al metodo, il risultato della verifica del sistema viene sovrascritto e il certificato viene accettato.

Interfaccia

Ingresso

Tipo di dati

Descrizione

hCert

SysTypes.RTS_IEC_HANDLE

Handle per il certificato del peer.

verifyResult

SysTypes.RTS_IEC_RESULT

Risultato della verifica eseguita dal sistema.

Per informazioni dettagliate sui codici di errore, vedere CmpX509Cert.ERRORS.

Esempio di implementazione

L'esempio seguente indica l'implementazione del callback che conferma il risultato del sistema assegnandolo al valore restituito del metodo. È possibile aggiungere ulteriori analisi per un errore rilevato:

METHOD VerifyCertCallback : TCPUDP.SysTypes.RTS_IEC_RESULT
VAR_INPUT
    hCert    : TCPUDP.SysTypes.RTS_IEC_HANDLE;
    verifyResult    : TCPUDP.SysTypes.RTS_IEC_RESULT;
END_VAR

VerifyCertCallback := verifyResult; IF verifyResult <> TCPUDP.CmpErrors.Errors.ERR_OK THEN
;
//Here you can analyze the error
END_IF