IValueMap::Add method (pla.h)

Adds an item to the collection.

Syntax

HRESULT Add(
  [in] VARIANT value
);

Parameters

[in] value

An IDispatch interface of the IValueMapItem interface to add to the collection. The variant type is VT_DISPATCH.

You can also add a string or integer value. If the value is an integer (the variant type is VT_I4, VT_UI4, VT_I8, or VT_UI8), PLA adds an item with the specified value.

If the value is a string (the variant type is VT_BSTR), PLA tries to convert the string to an integer. If successful, PLA adds an item with the specified integer value. If PLA cannot convert the string, PLA searches the collection for a key that matches the string. If found, PLA enables the item; otherwise, the add fails.

Return value

Returns S_OK if successful.

Requirements

Requirement Value
Minimum supported client Windows Vista [desktop apps only]
Minimum supported server Windows Server 2008 [desktop apps only]
Target Platform Windows
Header pla.h
DLL Pla.dll

See also

IValueMap

IValueMap::AddRange

IValueMap::Remove