Hitachi

JP1 Version 11 JP1/IT Desktop Management 2 Distribution Function Administration Guide


AIT_RegSetDWORDValue

Organization of this page

Description

Sets data to a registry value of the DWORD-type.

Format

bool AIT_RegSetDWORDValue(
  integer nHKeyHandle,      // Key handle
  string strRegKeyName,     // Registry sub-key name
  string strRegValueName,   // Registry value name
  integer nRegValueData     // Registry value data
);

Parameters

nHKeyHandle (input)

Specify a handle to an already opened registry key, or one of the following values.

  • HKEY_CLASSES_ROOT

  • HKEY_CURRENT_CONFIG

  • HKEY_CURRENT_USER

  • HKEY_LOCAL_MACHINE

  • HKEY_USERS

strRegKeyName (input)

Specify a sub-key name for a registry.

strRegValueName (input)

Specify the name of a registry value you want to set.

nRegValueData (input)

Specify data you want to set to a registry value of the DWORD-type.

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 number

Error code

6

ERROR_INVALID_HANDLE

87

ERROR_INVALID_PARAMETER

234

ERROR_MORE_DATA

1009

ERROR_BADDB

1010

ERROR_BADKEY

1011

ERROR_CANTOPEN

1013

ERROR_CANTWRITE

1015

ERROR_REGISTRY_CORRUPT

1016

ERROR_REGISTRY_IO_FAILED

1018

ERROR_KEY_DELETED

1019

ERROR_NO_LOG_SPACE

1169

ERROR_NO_MATCH