IaDsDeleteOps (interfaz)

La interfaz IADsDeleteOps se usa en rutinas de supervisión y mantenimiento para el almacén de directorios subyacente. Puede eliminar objetos hoja y subárboles completos en una sola operación.

Si no se admita esta interfaz, la eliminación de un objeto de Active Directory requeriría que cada objeto contenido se enumerase y eliminara de forma recursiva. Con esta interfaz, cualquier objeto contenedor, con todos sus objetos y subobjetos contenidos, se puede eliminar con una sola operación.

En el ejemplo de código siguiente se elimina el contenedor "Eng" y todos los objetos secundarios.

HRESULT hr;
IADsDeleteOps *pDeleteOps;
LPWSTR pwszUsername = NULL;
LPWSTR pwszPassword = NULL;

// Insert code to securely retrieve the pwszUsername and pwszPassword
// or leave as NULL to use the default security context of the 
// calling application.
 
// Bind to the LDAP provider.
hr = ADsOpenObject(L"LDAP://CN=Eng,CN=Users,DC=Fabrikam,DC=Com", 
    pwszUsername,
    pwszPassword,
    0,
    ADS_SECURE_AUTHENTICATION,
    IID_IADsDeleteOps, 
    (void**)&pDeleteOps);
if(S_OK == hr)
{
    // Delete the container and all child objects.
    pDeleteOps->DeleteObject(0);

    // Release the interface.
    pDeleteOps->Release();
}

if(pwszUsername)
{
    SecureZeroMemory(pwszUsername, lstrlen(pwszUsername) * sizeof(TCHAR));
}
if(pwszPassword)
{
    SecureZeroMemory(pwszPassword, lstrlen(pwszPassword) * sizeof(TCHAR));
}

En el ejemplo de código siguiente se elimina el contenedor "Eng" y todos los objetos secundarios.

Dim DeleteOps As IADsDeleteOps

' Bind to the LDAP provider.
Set DeleteOps = GetObject("LDAP://CN=Eng,CN=Users,DC=Fabrikam,DC=Com")

' Delete the container and all child objects.
DeleteOps.DeleteObject (0)