IADsPropertyList::Next, méthode (iads.h)
La méthode IADsPropertyList::Next obtient l’élément suivant dans la liste des propriétés. L’élément retourné est un objet Property Entry.
Syntaxe
HRESULT Next(
[out] VARIANT *pVariant
);
Paramètres
[out] pVariant
Adresse d’une variable allouée par l’appelant qui contient la valeur de l’élément suivant dans la liste de propriétés. La valeur de retour de VT_DISPATCH fait référence à un pointeur d’interface IDispatch vers un objet implémentant l’interface IADsPropertyEntry .
Valeur retournée
Cette méthode prend en charge les valeurs HRESULT standard, y compris S_OK si l’élément est obtenu. Lorsque le dernier élément de la liste est retourné, la valeur de retour retournée diffère selon le fournisseur utilisé. Les codes suivants sont utilisés pour indiquer que le dernier élément de la liste a été obtenu :
Pour plus d’informations et d’autres valeurs de retour, consultez Codes d’erreur ADSI.
Notes
Vous devez effacer pVariant à l’aide deVariantClear lorsque la valeur retournée par la méthode Next n’est plus requise.
Exemples
L’exemple de code suivant montre comment parcourir une liste de propriétés à l’aide de la méthode Next .
Dim propList As IADsPropertyList
Dim v as Variant
Dim propVal As IADsPropertyValue
On Error Resume Next
Set propList = GetObject("LDAP://dc01/DC=Fabrikam,DC=com")
propList.GetInfo
Set v = propList.Next()
While (Not (IsNull(v)) And Err.Number = 0)
Set propEnty = v
Debug.Print v.Name
Debug.Print v.AdsType
Set v = propList.Next
Wend
L’exemple de code C++ suivant montre comment utiliser la méthode IADsPropertyList::Next .
////////////////////////////////////
// Function used to retrieve an entry using the
// IADsPropertyList::Next method.
// name: GetNextEntry
// input: IADsPropertyList*
// return: IADsPropertyEntry
// uses: IADsPropertyList::Next
/////////////////////////////////////////////////////////
IADsPropertyEntry* GetNextEntry(IADsPropertyList* pList)
{
VARIANT var;
VariantInit(&var);
IADsPropertyEntry *pEntry;
if(!pList)
{
_tprintf("An error has occurred.");
return NULL;
}
HRESULT hr = pList->Next(&var);
hr = V_DISPATCH(&var)->QueryInterface(IID_IADsPropertyEntry,
(void**)&pEntry);
VariantClear(&var);
return pEntry;
}
Configuration requise
| Client minimal pris en charge | Windows Vista |
| Serveur minimal pris en charge | Windows Server 2008 |
| Plateforme cible | Windows |
| En-tête | iads.h |
| DLL | Activeds.dll |