IADsPropertyList::P urgePropertyList 메서드(iads.h)
IADsPropertyList::P urgePropertyList 메서드는 속성 목록에서 모든 항목을 삭제합니다.
구문
HRESULT PurgePropertyList();
반환 값
이 메서드는 S_OK 포함하여 표준 HRESULT 반환 값을 지원합니다. 자세한 내용 및 기타 반환 값은 ADSI 오류 코드를 참조하세요.
설명
PurgePropertyList 메서드가 호출되면 모든 항목이 캐시에서 제거됩니다. 따라서 그 후에 GetPropertyItem 을 호출하면 오류가 발생합니다. PurgePropertyList는 캐시의 내용에만 영향을 미치며 디렉터리의 실제 개체에 대한 속성에는 영향을 주지 않습니다. 즉, PurgePropertyList를 호출한 후 SetInfo를 호출해도 디렉터리 개체의 속성은 삭제되지 않습니다.
예제
다음 코드 예제에서는 IADsPropertyList::P urgePropertyList를 구현하는 방법을 보여 줍니다.
Dim propList As IADsPropertyList
On Error GoTo Cleanup
Set propList = GetObject("LDAP://dc03/DC=Fabrikam,DC=com")
propList.GetInfo
propList.PurgePropertyList
'- None of GetPropertyItem should work, because the list is purged.
'- The following line should generate error.
Set propEntry = propList.GetPropertyItem("adminDescription", ADSTYPE_CASE_IGNORE_STRING)
Cleanup:
If (Err.Number<>0) Then
MsgBox("An error has occurred. " & Err.Number)
End If
Set propList = Nothing
다음 코드 예제에서는 IADsPropertyList::P urgePropertyList 호출에 의해 생성된 효과를 보여 줍니다. GetPropertyCache 함수 및 코드 예제에 대한 자세한 내용은 IADsPropertyList를 참조하세요.
IADsPropertyList *GetPropertyCache(LPWSTR);
void TestPurgePropertyList()
{
IADsPropertyList *pList;
pList=GetPropertyCache(L"WinNT://myComputer,computer");
long count;
if(pList)
{
pList->get_PropertyCount(&count);
printf("Number of properties before purging: %d\n",count);
count = -1;
pList->PurgePropertyList();
pList->get_PropertyCount(&count);
printf("Number of properties after purging: %d\n",count);
}
}
요구 사항
| 지원되는 최소 클라이언트 | Windows Vista |
| 지원되는 최소 서버 | Windows Server 2008 |
| 대상 플랫폼 | Windows |
| 헤더 | iads.h |
| DLL | Activeds.dll |