com.registry

Class RegQWORDValue

java.lang.Object

com.registry.RegistryValue

com.registry.RegQWORDValue

All Implemented Interfaces:

Serializable, Cloneable, Comparable<RegistryValue>

public class RegQWORDValue
extends RegistryValue

This class represents a named value of type REG_QWORD or REG_QWORD_LITTLE_ENDIAN. The type specific data for the value will be a Long.

Version:

1.8

Author:

Yinon Michaeli

See Also:

RegistryValue, Serialized Form

Field Summary

Fields inherited from class com.registry.RegistryValue

key, name, type, typei, value

Method Summary

Methods

Modifier and Type	Method and Description
long	getLongValue() Convenience method to retrieve the data as a long primitive data type.
Long	getValue() Retrieves the type specific form of this value which is a Long.
int	refreshData() This method is used to update the data for this value because the data does not update automatically if it was changed.
int	setLongValue(long value) Convenience method to set the data using a long primitive data type.
int	setValue(Long value) Used to set the data of this value.
String	toString() Retrieve a String representation of this value.

Methods inherited from class com.registry.RegistryValue

clone, compareTo, equals, getByteData, getByteLength, getKey, getName, getValueType, getValueTypeInt, hashCode, setByteData, setValueType, setValueTypeInt

Methods inherited from class java.lang.Object

finalize, getClass, notify, notifyAll, wait, wait, wait

Method Detail

getValue

public Long getValue()

Retrieves the type specific form of this value which is a Long.

The Windows Registry uses unsigned integers for QWORDs, so negative values may be returned.

If the type was changed through a call to RegistryValue.setValueType(ValueType) and is no longer of type REG_QWORD or REG_QWORD_LITTLE_ENDIAN, then a RegistryException is thrown.

If the byte length for the data is not equal to 8, then a RegistryException is also thrown.

Returns:

A Long representing the data.

Throws:

RegistryException - if the type is not REG_QWORD or REG_QWORD_LITTLE_ENDIAN; or if the byte length is not 8.

getLongValue

public long getLongValue()

Convenience method to retrieve the data as a long primitive data type.

Returns:

A long primitive data type representing the data.

See Also:

getValue()

setValue

public int setValue(Long value)

Used to set the data of this value. If the type is no longer of type REG_QWORD or REG_QWORD_LITTLE_ENDIAN, then a RegistryException is thrown.

Parameters:

value - A Long representing the new data for the value.

Returns:

An integer error code which tells if the operation was successful or not. To obtain a description of the error, use RegistryKey.formatErrorMessage(int).

Throws:

RegistryException - if the type is not REG_QWORD or REG_QWORD_LITTLE_ENDIAN.

setLongValue

public int setLongValue(long value)

Convenience method to set the data using a long primitive data type.

Parameters:

value - A long primitive data type representing the new data for the value.

Returns:

An integer error code which tells if the operation was successful or not. To obtain a description of the error, use RegistryKey.formatErrorMessage(int).

See Also:

setValue(Long)

refreshData

public int refreshData()

This method is used to update the data for this value because the data does not update automatically if it was changed.

Specified by:

refreshData in class RegistryValue

Returns:

An integer error code which tells if the operation was successful or not. To obtain a description of the error, use RegistryKey.formatErrorMessage(int).

Throws:

RegistryException - if the type is not REG_QWORD_LITTLE_ENDIAN.

Since:

1.5

toString

public String toString()

Retrieve a String representation of this value.

Overrides:

toString in class RegistryValue

Returns:

A String representation for the value.