CBDirect Component
Properties Methods Events Configuration Settings Errors
The CBDirect component provides applications with low-level, direct access to disks and memory in Windows.
Syntax
TcbrCBDirect
Remarks
The CBDirect component is used to gain low-level, direct access to disks and memory in Windows. The component allows bypassing certain Windows access restrictions, even under limited user accounts.
Getting Started
All of the CBDirect component's methods are independent, and can be called immediately after creating an instance of the component.
Here's how to get up and running:
- If the system driver hasn't been installed yet, call the Install method to do so. This only needs to be done once.
- In production, the system driver can be installed (or updated) ahead-of-time by the application's installation script using the Installer DLL. Please refer to the Driver Installation topic for more information.
- Call the component's methods as needed.
- To uninstall the system driver, call the Uninstall method. This should not be done as part of the driver upgrade process.
- In production, the system driver can be uninstalled by the application's uninstallation script using the Installer DLL. Please refer to the Driver Installation topic for more information.
Property List
The following is the full list of the properties of the component with short descriptions. Click on the links for further details.
Tag | Stores application-defined data specific to this instance of the component. |
Method List
The following is the full list of the methods of the component with short descriptions. Click on the links for further details.
Config | Sets or retrieves a configuration setting. |
CreateFile | Creates or opens a file or directory by passing the request directly to the filesystem. |
CreateFileAsStream | Creates or opens a file as a stream by passing the request directly to the filesystem. |
DelFile | Deletes a file by passing the request directly to the filesystem. |
GetDriverStatus | Retrieves the status of the component's system driver. |
GetDriverVersion | Retrieves the version of the component's system driver. |
GetSectorCount | Returns the number of sectors on the specified disk device. |
GetSectorSize | Returns the sector size used by the specified disk device. |
Initialize | Initializes the component. |
Install | Installs (or upgrades) the component's system driver. |
OpenMemory | Provides raw, read-only access to the system's physical memory. |
OpenMemoryAsStream | Provides raw, read-only access to the system's physical memory as a stream. |
OpenVolume | Opens a volume. |
OpenVolumeAsStream | Opens a volume as a stream. |
ReadSectors | Reads data from sectors of a disk. |
ShutdownSystem | Shuts down or reboots the operating system. |
Uninstall | Uninstalls the component's system driver. |
WriteSectors | Writes data to sectors on a disk. |
Event List
The following is the full list of the events fired by the component with short descriptions. Click on the links for further details.
Error | Fires if an unhandled error occurs during an event. |
Configuration Settings
The following is a list of configuration settings for the component with short descriptions. Click on the links for further details.
BuildInfo | Information about the product's build. |
LicenseInfo | Information about the current license. |