Active Directory Provider::Delete Object

Deletes the specified Microsoft® Active Directory® object. Used by Microsoft® Provisioning Framework (MPF).

Delete Object is a wrapper for IADsDeleteOps::DeleteObject.

XML Input Schema

The following code fragment shows the format for sending data to this procedure. For more information on individual elements and attributes, see the Elements and Attributes table.

<executeData>1..1
 <path>1..1</path>
 <flagIgnoreDoesNotExistError>0..1</flagIgnoreDoesNotExistError>
</executeData>

XML Output Schema

Delete Object does not return data.

Elements and Attributes

The following table describes the XML schema elements and attributes. Unless otherwise indicated, the data type is string.

Element Description, relationships, and attributes
executeData Description:
 Encapsulates the procedure's input data.

Children:
 flagIgnoreDoesNotExistError ( minOccurs="0" maxOccurs="1")
path ( minOccurs="1" maxOccurs="1")
flagIgnoreDoesNotExistError Description:
 Specifies whether the delete succeeds if the object does not exist. Ordinarily, the procedure would fail. However, if this element is included in the input XML, the delete succeeds, as does any rollback for the delete.

Parent:
executeData

path Description:
 Lightweight directory access protocol (LDAP) path of the object to delete.

Parent:
executeData

Remarks

To delete subtrees, this procedure must have permission to execute Delete Subtree in the Active Directory Users and Computers (ADUC) console.

See Also

Active Directory Provider, Create Object, Preferred DC Active Directory Provider

Up Top of Page
© 1999-2002 Microsoft Corporation. All rights reserved.