Function EricChangePassword 

pub unsafe extern "C" fn EricChangePassword(
    psePath: *const byteChar,
    oldPin: *const byteChar,
    newPin: *const byteChar,
) -> c_int

@brief Die PIN für ein clientseitig erzeugtes Zertifikat (CEZ) wird geändert.

Die Funktion ändert die bei der Funktion EricCreateKey() angegebene PIN und entsprechend hierfür die Prüfsumme in der Datei \c eric.sfv. Falls die Datei \c eric.sfv nicht vorhanden ist, wird sie, wie bei EricCreateKey(), erstellt. Eine PIN-Änderung von einem Portalzertifikat (POZ) ist nicht möglich.

Pfade müssen auf Windows in der für Datei-Funktionen benutzten ANSI-Codepage, auf Linux, AIX und Linux Power in der für das Dateisystem benutzten Locale und auf macOS in der “decomposed form” von UTF-8 übergeben werden. Bitte weitere Betriebssystemspezifika bzgl. nicht erlaubter Zeichen in Pfaden und Pfadtrennzeichen beachten.

Für Details zu Pfaden im ERiC siehe @typeDokumentation{ERiC-Entwicklerhandbuch.pdf}, Kapitel “Übergabe von Pfaden an ERiC API-Funktionen”

@param[in] psePath In dem angegebenen Pfad liegt das Schlüsselpaar \c eric_private.p12 und \c eric_public.cer @param[in] oldPin Bisherige PIN. @param[in] newPin Neue PIN. Die Mindestlänge beträgt 4 Stellen. Zulässige Zeichen sind alle ASCII-Zeichen ohne die Steuerzeichen.

@return - ::ERIC_OK - ::ERIC_GLOBAL_UNGUELTIGER_PARAMETER - ::ERIC_GLOBAL_UNGUELTIGER_PARAMETER - ::ERIC_GLOBAL_NICHT_GENUEGEND_ARBEITSSPEICHER - ::ERIC_GLOBAL_UNKNOWN - ::ERIC_CRYPT_PIN_STAERKE_NICHT_AUSREICHEND - ::ERIC_CRYPT_PIN_ENTHAELT_UNGUELTIGE_ZEICHEN - ::ERIC_CRYPT_E_PSE_PATH - ::ERIC_CRYPT_NICHT_UNTERSTUETZTES_PSE_FORMAT - ::ERIC_CRYPT_ERROR_CREATE_KEY

@see - EricCreateKey() - @typeDokumentation{ERiC-Entwicklerhandbuch.pdf}, Kap. “Zuordnung der API-Funktionen zur Verwendung von POZ, CEZ und AHZ”