Edit

IDirectoryObject::DeleteDSObject method (iads.h)

  • Article

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

Requirement Value
Minimum supported client Windows Vista
Minimum supported server Windows Server 2008
Target Platform Windows
Header iads.h
DLL Activeds.dll

See also

ADSI Error Codes

IADsDeleteOps::DeleteObject

IDirectoryObject