Método IADsPropertyList::P urgePropertyList (iads.h)
El método IADsPropertyList::P urgePropertyList elimina todos los elementos de la lista de propiedades.
Sintaxis
HRESULT PurgePropertyList();
Valor devuelto
Este método admite los valores devueltos HRESULT estándar, incluidos los S_OK. Para obtener más información y otros valores devueltos, consulta Códigos de error ADSI.
Comentarios
Cuando se llama al método PurgePropertyList , todos los elementos se quitan de la memoria caché. Por lo tanto, llamar a GetPropertyItem después de eso generará un error. Tenga en cuenta que PurgePropertyList solo afecta al contenido de la memoria caché y no afecta a las propiedades del objeto real del directorio; Es decir, llamar a SetInfo después de llamar a PurgePropertyList no elimina las propiedades del objeto de directorio.
Ejemplos
En el ejemplo de código siguiente se muestra cómo implementar 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
En el ejemplo de código siguiente se muestra el efecto generado por una llamada a IADsPropertyList::P urgePropertyList. Para obtener más información sobre la función GetPropertyCache y un ejemplo de código, vea 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);
}
}
Requisitos
| Cliente mínimo compatible | Windows Vista |
| Servidor mínimo compatible | Windows Server 2008 |
| Plataforma de destino | Windows |
| Encabezado | iads.h |
| Archivo DLL | Activeds.dll |