check_license()

Prüft, ob die angegebenen Module auf dem verbundenen Server lizenziert sind, über lic.CheckLicense. Mehrere Modulnamen können übergeben werden und werden als einzelner leerzeichengetrennter String an den Server gesendet.

Dieser Endpunkt funktioniert nur für Module mit dem Lizenztyp Concurrent (ECMLicenseType.CONCURRENT). Module mit dem Lizenztyp Named (ECMLicenseType.NAMED) oder Universal (ECMLicenseType.UNIVERSAL) werden als unlizenziert gemeldet, auch wenn sie auf dem Server vorhanden sind. Verwenden Sie module_info(), um den Lizenztyp eines Moduls zu ermitteln.

1. Signatur

  • Sync

  • Async

ecm.system.check_license(*modules: str) -> list[ECMLicenseInfo]
await ecm.system.check_license(*modules: str) -> list[ECMLicenseInfo]

2. Parameter

Parameter Typ Standard Beschreibung

*modules

str

—

Ein oder mehrere Modulnamen zur Prüfung (z.B. "ASC", "CLU").

3. Rückgabewert

Eine Liste von ECMLicenseInfo-Instanzen, eine pro angefordertem Modul.

3.1. Felder von ECMLicenseInfo

Feld Typ Beschreibung

module

str

Der Modulname, der geprüft wurde.

licensed

bool

True, wenn das Modul auf dem verbundenen Server lizenziert ist.

result

int

Der vom Server zurückgegebene Ergebniscode. 0 bedeutet lizenziert.

4. Beispiele

4.1. Einzelnes Modul prüfen

  • Sync

  • Async

infos = ecm.system.check_license("ASC")
if infos[0].licensed:
    print("ASC module is licensed")
infos = await ecm.system.check_license("ASC")
if infos[0].licensed:
    print("ASC module is licensed")

4.2. Mehrere Module gleichzeitig prüfen

  • Sync

  • Async

infos = ecm.system.check_license("ASC", "CLU", "WFL")
for info in infos:
    status = "licensed" if info.licensed else f"not licensed (code={info.result})"
    print(f"{info.module}: {status}")
infos = await ecm.system.check_license("ASC", "CLU", "WFL")
for info in infos:
    status = "licensed" if info.licensed else f"not licensed (code={info.result})"
    print(f"{info.module}: {status}")

5. Siehe auch

  • module_info() — Detaillierte Lizenzinformationen eines Moduls abrufen