IRegValues::Add

[This is preliminary documentation and subject to change.]

Creates a new Registry Value.

A new RegValue object is returned. The new value is, however, not written to the System Registry before you assign a value to the new object.

HRESULT Add(
  BSTR Item,
  IRegValue * * ppvObject,
);

Parameters

Item

[in] The name of the Registry entry.

ppvObject

[out, retval] The returned object.

Return Values

S_OK

The operation was successfull.

E_POINTER

A NULL pointer was supplied as an argument.

E_UNEXPECTED

An unexpected error occoured.

E_FAIL

A general error occoured.

Remarks

If the Registry Node already exists the method still succeeds. The previous value will be overwritten when new values are assigned to the object.

See Also

IRegValues, IRegValue