Metodo IADsPropertyList::P urgePropertyList (iads.h)

Il metodo IADsPropertyList::P urgePropertyList elimina tutti gli elementi dall'elenco delle proprietà.

Sintassi

HRESULT PurgePropertyList();

Valore restituito

Questo metodo supporta i valori restituiti HRESULT standard, inclusi i S_OK. Per altre informazioni e altri valori restituiti, vedere Codici di errore ADSI.

Commenti

Quando viene chiamato il metodo PurgePropertyList , tutti gli elementi vengono rimossi dalla cache. Quindi, chiamando GetPropertyItem dopo che genererà un errore. Tenere presente che PurgePropertyList influisce solo sul contenuto della cache e non influisce sulle proprietà sull'oggetto effettivo nella directory; ovvero, la chiamata a SetInfo dopo aver chiamato PurgePropertyList non elimina le proprietà nell'oggetto directory.

Esempio

Nell'esempio di codice seguente viene illustrato come implementare 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

Nell'esempio di codice seguente viene illustrato l'effetto prodotto da una chiamata a IADsPropertyList::P urgePropertyList. Per altre informazioni sulla funzione GetPropertyCache e un esempio di codice, vedere 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);
    }
}

Requisiti

Client minimo supportato	Windows Vista
Server minimo supportato	Windows Server 2008
Piattaforma di destinazione	Windows
Intestazione	iads.h
DLL	Activeds.dll

Vedi anche

Codici di errore ADSI

IADsPropertyList

Metodi di proprietà IADsPropertyList

IADsPropertyList::GetPropertyItem