Add Method of the ISdoCollection Interface

The Add method adds an item to the Server Data Objects (SDO) collection.

HRESULT Add(
  [in]                 BSTR bstrName,
  [in, out]            IDispatch** ppItem
);

bstrName
Specifies the name of the SDO Object. This parameter may be NULL.
ppItem
Pointer to an IDispatch interface pointer for the Item to add. This parameter must not be NULL.

If the method succeeds the return value is S_OK.

If the method fails, the return value is one of the following error codes.

Value	Meaning
E_ABORT	The operation was aborted.
E_FAIL	An unspecified error occurred.
E_INVALIDARG	One of the parameters is invalid.
E_NOINTERFACE	A specified interface is not supported.
E_NOTIMPL	A specified method is not implemented.
E_OUTOFMEMORY	The method was unable to allocate required memory.
E_POINTER	A pointer passed as a parameter is not valid.
E_UNEXPECTED	The method failed for unknown reasons.

If you specify the name of the object to add, ensure that the name is unique by calling ISdoCollection::IsNameUnique.

If the bstrName parameter is not specified, ISdoCollection::Add obtains it from the object specified by the ppItem parameter.

Server	Requires Windows Server 2008, Windows Server 2003, or Windows 2000 Server.
Header	Declared in SdoIas.h.
IDL	Declared in SdoIas.idl.
DLL	Requires Iassdo.dll.

Additional resources