|
pure virtual |
Add the delete attribute batch item to the current request message.
A successful startRequestMsg function must be called first.
Delete Attribute, this operation allows the modification of an existing attribute of a managed object specified by a unique identifer. A single instance of an attribute can be deleted per delete attribute request. A specific attribute instance (of a multi-instance attribute) is selected to be deleted by matching the value given in the pAttribute parameter.
However, if no attribute value is specified then all instances of the specified attribute shall be deleted. This can be done by setting: "pAttribute->attribute.type = 0" and the pAttributeRef parameter is used to indicate the attribute to delete.
uniqueIdentifier | [ in ] optional uniqueIdentifier.pString can be NULL, delete the attribute associated with the managed object pointed to by this unique Id. If NULL the sserver determines the object to query. |
pAttribute | [ in ] the value of the attribute to be deleted |
pAttributeRef | [ in ] optional can be NULL, only used when all instances of an attribute are to be deleted (see description above) |
pExtension | [ in ] optional can be NULL, vendor defined extension to the operation |
Success | P6R::eOk | |
Failure | P6R::eNotInitialized | A successful call to intialize() must be made before calling this funciton. |
P6R::eInvalidArg | pAttribute is NULL | |
P6R::eTooSmall | The configured buffer size in pPool is too small to hold the generated message. | |
P6R::eInvalidState | A successful call to startRequestMsg() must be made before calling this function. | |
P6R::eRange | pExtension->encodedExtension.length must be a multiple of 8, since encoded as the Vendor Extension Structure |