VHL.GetFileInfo
This command returns the available size of the VHL-file whose ID is specified by the ID parameter. Two values are returned: the length of the VHL-file ( Len ) and the size of a single block ( BlockSize ).
The size of the returned value Len indicates the maximum number of bytes which can be read/written with the VHL.Read or VHL.Write commands. Attempting to read or write a larger amount of Bytes with VHL.Read or VHL.Write will generate an error status code ( VHL.ErrRead or VHL.ErrWrite ).
If the card system organizes its memory in blocks, BlockSize returns the size of a single block. If the memory is not organized in blocks, 1 will be returned. 0 will be returned if the block sizes are not unique (currently, there is no such card system in existence).
This command can only be executed if a card is selected, e.g. with a previous call of VHL.Select.
The returned VHL-file size corresponds to the reader's configuration values. It does not necessarily guarantee that a file of the returned sized can be read on the card. In some cases, the actual size of the card may be smaller than the returned VHL-file size.
Properties
- Command code: 0x010D
- Command timeout: 100 ms
- Possible status codes: General status codes, VHL.ErrCardNotSelected, VHL.ErrConfig
Parameters (request frame)
| Name | Type/Size | Description |
|---|---|---|
| Id | Integer (8 bits) |
ID of VHL-file in configuration memory (starting at 0). To keep your application ConfigEditor compatible do not hardcode this ID in your application, but resolve it from a name via VHL.ResolveFilename. |
Returned values (response frame)
| Name | Type/Size | Description |
|---|---|---|
| Len | Integer (16 bits) | Size of VHL-file in bytes. |
| BlockSize | Integer (8 bits) | Size of a single block. |