AIT_RegDeleteKey

Description

Deletes a sub-key for a specified registry.

Format

bool AIT_RegDeleteKey(
 integer nHKeyHandle,     // Key handle
 string strRegKeyName     // Name of a key to be deleted
);

Parameters

nHKeyHandle (input)

Specify a handle to an already opened registry key.

strRegKeyName (input)

Specify a sub-key name for a registry to be deleted.

Return values

The return value is true if the function was executed normally, and false if not. If the function has returned false, you can use AIT_GetLastError to acquire an extended error code. The following gives the error codes that AIT_GetLastError might return:

Extended error numberError code
2ERROR_FILE_NOT_FOUND
5ERROR_ACCESS_DENIED
6ERROR_INVALID_HANDLE
87ERROR_INVALID_PARAMETER
1009ERROR_BADDB
1010ERROR_BADKEY
1015ERROR_REGISTRY_CORRUPT
1016ERROR_REGISTRY_IO_FAILED
1019ERROR_NO_LOG_SPACE

Note

When the OS of the computer is Windows, if the specified key has a sub-key, you cannot delete the specified key. Before deleting a key, delete all of its sub-keys.