IDirectoryObject::DeleteDSObject method (iads.h)

The IDirectoryObject::DeleteDSObject method deletes a leaf object in a directory tree.

Syntax

HRESULT DeleteDSObject(
  LPWSTR pszRDNName
);

Parameters

pszRDNName

The relative distinguished name (relative path) of the object to be deleted.

Return value

This method returns the standard return values, including S_OK for a successful operation. For more information and other return values, see ADSI Error Codes.

Remarks

To delete a container object and its children, use the IADsDeleteOps::DeleteObject method.

Examples

The following C/C++ code example shows how to delete a user object.

HRESULT hr;
IDirectoryObject *pDirObject=NULL;
hr = ADsGetObject(L"LDAP://OU=Sales,DC=Fabrikam,DC=com",
    IID_IDirectoryObject, (void**) &pDirObject );
 
if ( SUCCEEDED(hr) )
{
    hr = pDirObject->DeleteDSObject( L"CN=Jeff Smith" );

    pDirObject->Release();
} 

Requirements

See also

ADSI Error Codes

IADsDeleteOps::DeleteObject

IDirectoryObject