read_encrypted_itemT_read_encrypted_itemReadEncryptedItemReadEncryptedItemread_encrypted_item (Operator)
Name
read_encrypted_itemT_read_encrypted_itemReadEncryptedItemReadEncryptedItemread_encrypted_item — Lesen eines verschlüsselten Elements aus einer Datei.
Signatur
def read_encrypted_item(file_name: str) -> HHandle
Beschreibung
Der Operator read_encrypted_itemread_encrypted_itemReadEncryptedItemReadEncryptedItemReadEncryptedItemread_encrypted_item liest die Datei FileNameFileNameFileNameFileNamefileNamefile_name und
legt in EncryptedItemHandleEncryptedItemHandleEncryptedItemHandleEncryptedItemHandleencryptedItemHandleencrypted_item_handle ein neues verschlüsseltes Element an, das
eine exakte Kopie des gesicherten Elements in der Datei ist. Die Datei
FileNameFileNameFileNameFileNamefileNamefile_name muss mit dem Operator write_encrypted_itemwrite_encrypted_itemWriteEncryptedItemWriteEncryptedItemWriteEncryptedItemwrite_encrypted_item erzeugt
worden sein.
Die HALCON Dateiendung für das verschlüsselte Element ist '.henc'.
Ausführungsinformationen
- Multithreading-Typ: reentrant (läuft parallel zu nicht-exklusiven Operatoren).
- Multithreading-Bereich: global (kann von jedem Thread aufgerufen werden).
- Wird ohne Parallelisierung verarbeitet.
Dieser Operator liefert ein Handle zurück. Es ist zu beachten, dass der Zustand einer Instanz dieses Handletyps durch bestimmte Operatoren geändert werden kann, obwohl das Handle als Eingabeparameter in diesen Operatoren verwendet wird.
Parameter
FileNameFileNameFileNameFileNamefileNamefile_name (input_control) filename.read → HTuplestrHTupleHtuple (string) (string) (HString) (char*)
Name der Datei.
Defaultwert:
'encrypted_item.henc'
"encrypted_item.henc"
"encrypted_item.henc"
"encrypted_item.henc"
"encrypted_item.henc"
"encrypted_item.henc"
Dateiendung: .bin
EncryptedItemHandleEncryptedItemHandleEncryptedItemHandleEncryptedItemHandleencryptedItemHandleencrypted_item_handle (output_control) encrypted_item → HEncryptedItem, HTupleHHandleHTupleHtuple (handle) (IntPtr) (HHandle) (handle)
Handle des verschlüsselten Elements.
Ergebnis
read_encrypted_itemread_encrypted_itemReadEncryptedItemReadEncryptedItemReadEncryptedItemread_encrypted_item liefert den Wert 2 (H_MSG_TRUE), falls eine Datei mit
dem angegebenen Namen gefunden wurde und korrekt eingelesen werden konnte.
Ansonsten wird eine Fehlerbehandlung durchgeführt.
Nachfolger
decrypt_serialized_itemdecrypt_serialized_itemDecryptSerializedItemDecryptSerializedItemDecryptSerializedItemdecrypt_serialized_item
Siehe auch
write_encrypted_itemwrite_encrypted_itemWriteEncryptedItemWriteEncryptedItemWriteEncryptedItemwrite_encrypted_item,
encrypt_serialized_itemencrypt_serialized_itemEncryptSerializedItemEncryptSerializedItemEncryptSerializedItemencrypt_serialized_item
Modul
Foundation