3.1.4.13.6 CreateNewElement (Opnum 8)
The CreateNewElement method is received by the server in an RPC_REQUEST packet. In response, the server creates a new unattached IAppHostElement object that has the specified name. The name MUST be a supported name as defined by the IAppHostCollectionSchema of the specified IAppHostElementCollection.
-
HRESULT CreateNewElement( [in, defaultvalue("")] BSTR bstrElementName, [out, retval] IAppHostElement** ppElement );
bstrElementName: The name of the IAppHostElement to be created.
ppElement: Contains a new IAppHostElement object.
Return Values: The server MUST return zero if it successfully processes the message that is received from the client. In this case, *ppElement is not NULL. If processing fails, the server MUST return a nonzero HRESULT code as defined in [MS-ERREF]. The following table describes the error conditions that MUST be handled and the corresponding error codes. A server MAY return additional implementation-specific error codes.
-
Return value/code
Description
0X00000000
NO_ERROR
The operation completed successfully.
0X80070057
ERROR_INVALID_PARAMETER
One or more parameters are incorrect or null.
0X00000008
ERROR_NOT_ENOUGH_MEMORY
Not enough memory is available to process this command.
0X80070021
ERROR_LOCK_VIOLATION
The instance is not editable.
0X80070585
ERROR_INVALID_INDEX
The schema does not permit the creation of an element with name bstrElementName.