Метод IADsPropertyList::Next (iads.h)
Метод IADsPropertyList::Next получает следующий элемент в списке свойств. Возвращаемый элемент является объектом Property Entry.
Синтаксис
HRESULT Next(
[out] VARIANT *pVariant
);
Параметры
[out] pVariant
Адрес переменной, выделенной вызывающим объектом, которая содержит значение следующего элемента в списке свойств. Возвращаемое значение VT_DISPATCH ссылается на указатель интерфейса IDispatch на объект, реализующий интерфейс IADsPropertyEntry .
Возвращаемое значение
Этот метод поддерживает стандартные значения HRESULT , включая S_OK , если элемент получен. При возвращении последнего элемента в списке возвращаемое значение будет отличаться в зависимости от используемого поставщика. Следующие коды используются для указания того, что был получен последний элемент в списке:
Дополнительные сведения и другие возвращаемые значения см. в разделе Коды ошибок ADSI.
Комментарии
Необходимо очистить pVariant с помощью VariantClear , если значение, возвращаемое методом Next , больше не требуется.
Примеры
В следующем примере кода показано, как просмотреть список свойств с помощью метода 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
В следующем примере кода C++ показано, как работать с методом 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;
}
Требования
| Минимальная версия клиента | Windows Vista |
| Минимальная версия сервера | Windows Server 2008 |
| Целевая платформа | Windows |
| Header | iads.h |
| DLL | Activeds.dll |