Developer's Guide
 All Classes Namespaces Files Functions Variables Typedefs Enumerations Enumerator Macros Groups Pages
virtual P6R::P6ERR P6R::p6IKMIPRequest4::addDeleteAttributeRequest2 ( P6NCSTR  uniqueIdentifier,
P6KMIP_ATTRIBUTE pAttribute,
P6KMIP_ATTRIB_REFERENCE pAttributeRef,
P6KMIP_MSGEXTENSION pExtension 
)
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.

Parameters
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
Returns
SuccessP6R::eOk 
FailureP6R::eNotInitializedA successful call to intialize() must be made before calling this funciton.
P6R::eInvalidArgpAttribute is NULL
P6R::eTooSmallThe configured buffer size in pPool is too small to hold the generated message.
P6R::eInvalidStateA successful call to startRequestMsg() must be made before calling this function.
P6R::eRangepExtension->encodedExtension.length must be a multiple of 8, since encoded as the Vendor Extension Structure