Function eric_bindings::EricCloseHandleToCertificate

pub unsafe extern "C" fn EricCloseHandleToCertificate(
    hToken: EricZertifikatHandle,
) -> c_int

@brief Das Zertifikat-Handle @c hToken wird freigegeben.

Diese Funktion gibt das übergebene Zertifikat-Handle frei. Zertifikat-Handles sollten möglichst frühzeitig, d.h. wenn sie nicht mehr benötigt werden, mit EricCloseHandleToCertificate() freigegeben werden, spätestens jedoch zum Programmende bzw. vor dem Entladen der ericapi Bibliothek. Das Ad Hoc-Zertifikat eines neuen Personalausweises sollte immer genau dann freigegeben werden, wenn es nicht mehr benötigt wird, jedoch spätestens vor Ablauf der 24 Stunden, die das Ad Hoc-Zertifikat gültig ist. Tritt ein Fehler auf, kann die Fehlermeldung mit EricHoleFehlerText() ausgelesen werden.

@param[in] hToken Zertifikat-Handle wie von der Funktion EricGetHandleToCertificate() zurückgeliefert. @return - ::ERIC_OK - ::ERIC_CRYPT_E_INVALID_HANDLE - ::ERIC_GLOBAL_UNGUELTIGER_PARAMETER - ::ERIC_GLOBAL_NICHT_GENUEGEND_ARBEITSSPEICHER - ::ERIC_GLOBAL_UNKNOWN \n\n Nur bei Verwendung des neuen Personalausweises: - ::ERIC_TRANSFER_EID_CLIENTFEHLER - ::ERIC_TRANSFER_EID_FEHLENDEFELDER - ::ERIC_TRANSFER_EID_IDENTIFIKATIONABGEBROCHEN - ::ERIC_TRANSFER_EID_NPABLOCKIERT - ::ERIC_TRANSFER_EID_IDNRNICHTEINDEUTIG - ::ERIC_TRANSFER_EID_KEINCLIENT - ::ERIC_TRANSFER_EID_KEINKONTO - ::ERIC_TRANSFER_EID_SERVERFEHLER - ::ERIC_TRANSFER_ERR_CONNECTSERVER - ::ERIC_TRANSFER_ERR_NORESPONSE - ::ERIC_TRANSFER_ERR_PROXYAUTH - ::ERIC_TRANSFER_ERR_PROXYCONNECT - ::ERIC_TRANSFER_ERR_SEND - ::ERIC_TRANSFER_ERR_SEND_INIT - ::ERIC_TRANSFER_ERR_TIMEOUT

@see - EricGetHandleToCertificate() - EricGetPinStatus() - ERiC-Entwicklerhandbuch.pdf, Kap. “Authentifizierung mit dem neuen Personalausweis (nPA)”