Interfaccia IADsDeleteOps

L'interfaccia IADsDeleteOps viene usata nelle routine di supervisione e manutenzione per l'archivio directory sottostante. Può eliminare oggetti foglia e interi sottoalberi in una singola operazione.

Se questa interfaccia non è supportata, l'eliminazione di un oggetto da Active Directory richiede che ogni oggetto contenuto venga enumerato ed eliminato in modo ricorsivo. Con questa interfaccia, qualsiasi oggetto contenitore, con tutti i relativi oggetti e sottooggetti contenuti, può essere eliminato con una singola operazione.

Nell'esempio di codice seguente vengono eliminati il contenitore "Eng" e tutti gli oggetti figlio.

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));
}

Nell'esempio di codice seguente vengono eliminati il contenitore "Eng" e tutti gli oggetti figlio.

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)