IADsDeleteOps Interface

A interface IADsDeleteOps é usada em rotinas de supervisão e manutenção para o armazenamento de diretório subjacente. Ele pode excluir objetos de folha e subárvores inteiras em uma única operação.

Se essa interface não fosse suportada, a exclusão de um objeto do Active Directory exigiria que cada objeto contido fosse enumerado e excluído recursivamente. Com essa interface, qualquer objeto de contêiner, com todos os seus objetos e subobjetos contidos, pode ser excluído com uma única operação.

O exemplo de código a seguir exclui o contêiner "Eng" e todos os objetos filho.

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

O exemplo de código a seguir exclui o contêiner "Eng" e todos os objetos filho.

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)