삭제된 개체 검색
삭제된 개체는 삭제된 개체 컨테이너에 저장됩니다. Deleted Objects 컨테이너는 일반적으로 표시되지 않지만 관리자 그룹의 구성원이 지운 개체 컨테이너를 바인딩할 수 있습니다. 삭제된 개체 컨테이너의 내용을 열거할 수 있으며, ADS_SEARCHPREF_TOMBSTONE 검색 기본 설정과 함께 IDirectorySearch 인터페이스를 사용하여 개별 삭제된 개체 특성을 가져올 수 있습니다.
삭제된 개체 컨테이너는 Ntdsapi.h에 정의된 잘 알려진 GUID GUID_DELETED_OBJECTS_CONTAINER 바인딩하여 가져올 수 있습니다. 잘 알려진 GUID에 바인딩하는 방법에 대한 자세한 내용은 WKGUID를 사용하여 잘 알려진 개체에 바인딩을 참조하세요.
지운 편지함 컨테이너에 바인딩할 때 ADS_FAST_BIND 옵션을 지정합니다. 즉, IAD 및 IADsPropertyList와 같은 Active Directory 도메인 Services의 개체로 작업하는 데 사용되는 ADSI 인터페이스는 지운 개체 컨테이너에서 사용할 수 없습니다. 자세한 내용과 지운 편지함 컨테이너에 바인딩하는 방법을 보여 주는 코드 예제는 아래 GetDeletedObjectsContainer 예제 함수를 참조하세요.
삭제된 개체 열거
IDirectorySearch 인터페이스는 삭제된 개체를 검색하는 데 사용됩니다.
삭제된 개체를 열거하려면
- 지운 개체 컨테이너에 대한 IDirectorySearch 인터페이스를 가져옵니다. 이 작업은 지운 개체 컨테이너에 바인딩하고 IDirectorySearch 인터페이스를 요청하여 수행됩니다. 자세한 내용 및 Deleted Objects 컨테이너에 바인딩하는 방법을 보여 주는 코드 예제는 다음 GetDeletedObjectsContainer 함수 예제를 참조하세요.
- IDirectorySearch::SetSearchPreference 메서드를 사용하여 ADS_SEARCHPREF_SEARCH_SCOPE 검색 기본 설정을 ADS_SCOPE_ONELEVEL. ADS_SCOPE_SUBTREE 기본 설정도 사용할 수 있지만 삭제된 개체 컨테이너는 한 수준에 불과하므로 ADS_SCOPE_SUBTREE 사용하는 것은 중복됩니다.
- ADS_SEARCHPREF_TOMBSTONE 검색 기본 설정을 TRUE로 설정합니다. 이렇게 하면 검색에 삭제된 개체가 포함되도록 합니다.
- ADS_SEARCHPREF_PAGESIZE 검색 기본 설정을 1000보다 작거나 같은 값으로 설정합니다. 선택 사항이지만 이 작업이 수행되지 않으면 삭제된 개체를 1,000개 이하로 검색할 수 없습니다.
- IDirectorySearch::ExecuteSearch 호출에서 검색 필터를 "(isDeleted=TRUE)"로 설정합니다. 이렇게 하면 검색에서 isDeleted 특성이 TRUE로 설정된 개체만 검색합니다.
삭제된 개체를 열거하는 방법을 보여 주는 코드 예제 코드는 다음 EnumDeletedObjects 함수 예제를 참조하세요 .
LDAP 방언에 표시된 대로 검색 필터에 추가하여 검색을 더 구체화할 수 있습니다. 예를 들어 이름이 "Jeff"로 시작하는 삭제된 개체를 모두 검색하려면 검색 필터가 "(&(isDeleted=TRUE)(cn=Jeff*))"로 설정됩니다.
삭제된 개체는 삭제될 때 대부분의 특성을 제거하므로 삭제된 개체에 직접 바인딩할 수 없습니다. 삭제된 개체에 바인딩할 때 ADS_FAST_BIND 옵션을 지정해야 합니다. 즉, IAD 및 IADsPropertyList와 같은 Active Directory 도메인 Services 개체를 사용하는 데 사용되는 ADSI 인터페이스는 삭제된 개체 컨테이너에서 사용할 수 없습니다.
특정 삭제된 개체 찾기
삭제된 특정 개체를 찾을 수도 있습니다. 개체의 objectGUID 가 알려진 경우 해당 특정 objectGUID를 사용하여 개체를 검색하는 데 사용할 수 있습니다. 삭제된 특정 개체를 찾는 방법을 보여 주는 코드 예제 및 자세한 내용은 아래 FindDeletedObjectByGUID를 참조하세요.
GetDeletedObjectsContainer
다음 C++ 코드 예제에서는 지운 개체 컨테이너에 바인딩하는 방법을 보여 있습니다.
//***************************************************************************
//
// GetDeletedObjectsContainer()
//
// Binds to the Deleted Object container.
//
//***************************************************************************
HRESULT GetDeletedObjectsContainer(IADsContainer **ppContainer)
{
if(NULL == ppContainer)
{
return E_INVALIDARG;
}
HRESULT hr;
IADs *pRoot;
*ppContainer = NULL;
// Bind to the rootDSE object.
hr = ADsOpenObject(L"LDAP://rootDSE",
NULL,
NULL,
ADS_SECURE_AUTHENTICATION,
IID_IADs,
(LPVOID*)&pRoot);
if(SUCCEEDED(hr))
{
VARIANT var;
VariantInit(&var);
// Get the current domain DN.
hr = pRoot->Get(CComBSTR("defaultNamingContext"), &var);
if(SUCCEEDED(hr))
{
// Build the binding string.
LPWSTR pwszFormat = L"LDAP://<WKGUID=%s,%s>";
LPWSTR pwszPath;
pwszPath = new WCHAR[wcslen(pwszFormat) + wcslen(GUID_DELETED_OBJECTS_CONTAINER_W) + wcslen(var.bstrVal)];
if(NULL != pwszPath)
{
swprintf_s(pwszPath, pwszFormat, GUID_DELETED_OBJECTS_CONTAINER_W, var.bstrVal);
// Bind to the object.
hr = ADsOpenObject(pwszPath,
NULL,
NULL,
ADS_FAST_BIND | ADS_SECURE_AUTHENTICATION,
IID_IADsContainer,
(LPVOID*)ppContainer);
delete pwszPath;
}
else
{
hr = E_OUTOFMEMORY;
}
VariantClear(&var);
}
pRoot->Release();
}
return hr;
}
EnumDeletedObjects
다음 C++ 코드 예제에서는 Deleted Objects 컨테이너에서 개체를 열거하는 방법을 보여 있습니다.
//***************************************************************************
//
// EnumDeletedObjects()
//
// Enumerates all of the objects in the Deleted Objects container.
//
//***************************************************************************
HRESULT EnumDeletedObjects()
{
HRESULT hr;
IADsContainer *pDeletedObjectsCont = NULL;
IDirectorySearch *pSearch = NULL;
hr = GetDeletedObjectsContainer(&pDeletedObjectsCont);
if(FAILED(hr))
{
goto cleanup;
}
hr = pDeletedObjectsCont->QueryInterface(IID_IDirectorySearch, (LPVOID*)&pSearch);
if(FAILED(hr))
{
goto cleanup;
}
ADS_SEARCH_HANDLE hSearch;
// Only search for direct child objects of the container.
ADS_SEARCHPREF_INFO rgSearchPrefs[3];
rgSearchPrefs[0].dwSearchPref = ADS_SEARCHPREF_SEARCH_SCOPE;
rgSearchPrefs[0].vValue.dwType = ADSTYPE_INTEGER;
rgSearchPrefs[0].vValue.Integer = ADS_SCOPE_ONELEVEL;
// Search for deleted objects.
rgSearchPrefs[1].dwSearchPref = ADS_SEARCHPREF_TOMBSTONE;
rgSearchPrefs[1].vValue.dwType = ADSTYPE_BOOLEAN;
rgSearchPrefs[1].vValue.Boolean = TRUE;
// Set the page size.
rgSearchPrefs[2].dwSearchPref = ADS_SEARCHPREF_PAGESIZE;
rgSearchPrefs[2].vValue.dwType = ADSTYPE_INTEGER;
rgSearchPrefs[2].vValue.Integer = 1000;
// Set the search preference
hr = pSearch->SetSearchPreference(rgSearchPrefs, ARRAYSIZE(rgSearchPrefs));
if(FAILED(hr))
{
goto cleanup;
}
// Set the search filter.
LPWSTR pszSearch = L"(cn=*)";
// Set the attributes to retrieve.
LPWSTR rgAttributes[] = {L"cn", L"distinguishedName", L"lastKnownParent"};
// Execute the search
hr = pSearch->ExecuteSearch( pszSearch,
rgAttributes,
ARRAYSIZE(rgAttributes),
&hSearch);
if(SUCCEEDED(hr))
{
// Call IDirectorySearch::GetNextRow() to retrieve the next row of data
while(S_OK == (hr = pSearch->GetNextRow(hSearch)))
{
ADS_SEARCH_COLUMN col;
UINT i;
// Enumerate the retrieved attributes.
for(i = 0; i < ARRAYSIZE(rgAttributes); i++)
{
hr = pSearch->GetColumn(hSearch, rgAttributes[i], &col);
if(SUCCEEDED(hr))
{
switch(col.dwADsType)
{
case ADSTYPE_CASE_IGNORE_STRING:
case ADSTYPE_DN_STRING:
case ADSTYPE_PRINTABLE_STRING:
case ADSTYPE_NUMERIC_STRING:
case ADSTYPE_OCTET_STRING:
wprintf(L"%s: ", rgAttributes[i]);
for(DWORD x = 0; x < col.dwNumValues; x++)
{
wprintf(col.pADsValues[x].CaseIgnoreString);
if((x + 1) < col.dwNumValues)
{
wprintf(L",");
}
}
wprintf(L"\n");
break;
}
pSearch->FreeColumn(&col);
}
}
wprintf(L"\n");
}
// Close the search handle to cleanup.
pSearch->CloseSearchHandle(hSearch);
}
cleanup:
if(pDeletedObjectsCont)
{
pDeletedObjectsCont->Release();
}
if(pSearch)
{
pSearch->Release();
}
return hr;
}
FindDeletedObjectByGUID
다음 C++ 코드 예제에서는 개체의 objectGUID 속성에서 삭제된 특정 개체를 찾는 방법을 보여줍니다.
HRESULT FindDeletedObjectByGUID(IADs *padsDomain, GUID *pguid)
{
HRESULT hr;
IDirectorySearch *pSearch = NULL;
LPWSTR pwszGuid = NULL;
hr = padsDomain->QueryInterface(IID_IDirectorySearch, (LPVOID*)&pSearch);
if(FAILED(hr))
{
goto cleanup;
}
ADS_SEARCH_HANDLE hSearch;
// Search the entire tree.
ADS_SEARCHPREF_INFO rgSearchPrefs[2];
rgSearchPrefs[0].dwSearchPref = ADS_SEARCHPREF_SEARCH_SCOPE;
rgSearchPrefs[0].vValue.dwType = ADSTYPE_INTEGER;
rgSearchPrefs[0].vValue.Integer = ADS_SCOPE_SUBTREE;
// Search for deleted objects.
rgSearchPrefs[1].dwSearchPref = ADS_SEARCHPREF_TOMBSTONE;
rgSearchPrefs[1].vValue.dwType = ADSTYPE_BOOLEAN;
rgSearchPrefs[1].vValue.Boolean = TRUE;
// Set the search preference.
hr = pSearch->SetSearchPreference(rgSearchPrefs, 2);
if(FAILED(hr))
{
goto cleanup;
}
// Set the search filter.
hr = ADsEncodeBinaryData((LPBYTE)pguid, sizeof(GUID), &pwszGuid);
if(FAILED(hr))
{
goto cleanup;
}
LPWSTR pwszFormat = L"(objectGUID=%s)";
LPWSTR pwszSearch = new WCHAR[lstrlenW(pwszFormat) + lstrlenW(pwszGuid) + 1];
if(NULL == pwszSearch)
{
goto cleanup;
}
swprintf_s(pwszSearch, pwszFormat, pwszGuid);
FreeADsMem(pwszGuid);
// Set the attributes to retrieve.
LPWSTR rgAttributes[] = {L"cn", L"distinguishedName", L"lastKnownParent"};
// Execute the search.
hr = pSearch->ExecuteSearch( pwszSearch,
rgAttributes,
3,
&hSearch);
if(SUCCEEDED(hr))
{
// Call IDirectorySearch::GetNextRow() to retrieve the next row of data.
while(S_OK == (hr = pSearch->GetNextRow(hSearch)))
{
ADS_SEARCH_COLUMN col;
UINT i;
// Enumerate the retrieved attributes.
for(i = 0; i < ARRAYSIZE(rgAttributes); i++)
{
hr = pSearch->GetColumn(hSearch, rgAttributes[i], &col);
if(SUCCEEDED(hr))
{
switch(col.dwADsType)
{
case ADSTYPE_CASE_IGNORE_STRING:
case ADSTYPE_DN_STRING:
case ADSTYPE_PRINTABLE_STRING:
case ADSTYPE_NUMERIC_STRING:
wprintf(L"%s: ", rgAttributes[i]);
for(DWORD x = 0; x < col.dwNumValues; x++)
{
wprintf(col.pADsValues[x].CaseIgnoreString);
if((x + 1) < col.dwNumValues)
{
wprintf(L",");
}
}
wprintf(L"\n");
break;
case ADSTYPE_OCTET_STRING:
wprintf(L"%s: ", rgAttributes[i]);
for(DWORD x = 0; x < col.dwNumValues; x++)
{
GUID guid;
LPBYTE pb = col.pADsValues[x].OctetString.lpValue;
WCHAR wszGUID[MAX_PATH];
// Convert the octet string into a GUID.
guid.Data1 = *((long*)pb);
pb += sizeof(guid.Data1);
guid.Data2 = *((short*)pb);
pb += sizeof(guid.Data2);
guid.Data3 = *((short*)pb);
pb += sizeof(guid.Data3);
CopyMemory(&guid.Data4, pb, sizeof(guid.Data4));
// Convert the GUID into a string.
StringFromGUID2(guid, wszGUID, MAX_PATH);
wprintf(wszGUID);
if((x + 1) < col.dwNumValues)
{
wprintf(L",");
}
OutputDebugStringW(wszGUID);
OutputDebugStringW(L"\n");
{
DWORD a;
for(a = 0, *wszGUID = 0; a < col.pADsValues[x].OctetString.dwLength; a++)
{
swprintf_s(wszGUID + lstrlenW(wszGUID), L"%02X", *(LPBYTE)(col.pADsValues[x].OctetString.lpValue + a));
}
OutputDebugStringW(wszGUID);
OutputDebugStringW(L"\n");
}
}
wprintf(L"\n");
break;
}
pSearch->FreeColumn(&col);
}
}
wprintf(L"\n");
}
// Close the search handle to cleanup.
pSearch->CloseSearchHandle(hSearch);
}
cleanup:
if(pwszSearch)
{
delete pwszSearch;
}
if(pSearch)
{
pSearch->Release();
}
return hr;
}