ICcObjectContainer::AddObject
Other versions of this page are also available for the following:
.gif "A hyphen indicates that the information in this topic is not relevant for this platform, or that the platform does not support the API that is listed.")
.gif "A checkmark indicates that the information in this topic is relevant for this platform, and that any API listed is also supported on this platform.")
8/27/2008
This method adds a new Core Connectivity object to the current container.
In Windows Embedded CE 6.0, CoreCon HLAPI has been deprecated.
Syntax
HRESULT AddObject(
BSTR in_bstrName,
BSTR in_bstrID,
ICcObject** out_ppiObject
);
Parameters
- in_bstrName
[in] Name of the object.
- in_bstrID
[in] ID of the object.
- out_ppiObject
[out, retval] Pointer to the newly created object.
Return Value
| Value | Description |
|---|---|
S_OK |
A new object is created through the out parameter. |
E_INVALIDARG |
Invalid arguments. The strings must be non-NULL. The out parameter must be non-NULL. |
E_DUPLICATE |
An object with the same ID exists in the container. |
E_FAIL |
The return value for any other failure. |
E_OUTOFMEMORY |
The method could not allocate the bstr parameterin_bstrID, or in_bstrName. |
E_DATASTORE_XMLTEXT |
An input parameter, not XML text. |
E_DATASTORE_TYPEERROR |
A datastore internal type error. |
Remarks
You can use a query interface with out_ppiObject to find an appropriate Core Connectivity datastore interface.
For example, the ICcDeviceContainer interface can only add ICcDevice objects.
Requirements
| Header | ccdatastore.h |