ADsEnumerateNext 函式 (adshlp.h)
ADsEnumerateNext 函式會透過列舉值目前游標位置的指定項目數目來列舉。 當作業成功時,函式會傳回 variant 陣列中的列舉專案集。 傳回的項目數目可以小於指定的數位。
語法
HRESULT ADsEnumerateNext(
[in] IEnumVARIANT *pEnumVariant,
[in] ULONG cElements,
[out] VARIANT *pvar,
[out] ULONG *pcElementsFetched
);
參數
[in] pEnumVariant
類型: IEnumVARIANT*
列舉值物件上 IEnumVARIANT 介面的指標。
[in] cElements
類型: ULONG
要求的元素數目。
[out] pvar
類型: VARIANT*
所擷取之項目數組的指標。
[out] pcElementsFetched
類型: ULONG*
擷取的實際項目數目,可能小於所要求的項目數目。
傳回值
類型: HRESULT
這個方法支持標準傳回值。
如需其他傳回值的詳細資訊,請參閱 ADSI 錯誤碼。
備註
列舉容器中物件的一般程式包含下列專案:
首先,在該容器上建立列舉值物件。
其次,擷取 IEnumVARIANT 介面指標。
第三,呼叫 ADsEnumerateNext 函式,以從列舉值物件傳回一組列舉的專案。
第四,呼叫 ADSFreeEnumerator 函 式以釋放列舉值物件。
如需詳細資訊和程式代碼範例,請參閱 ADsBuildEnumerator 主題。
規格需求
需求 | 值 |
---|---|
最低支援的用戶端 | Windows Vista |
最低支援的伺服器 | Windows Server 2008 |
目標平台 | Windows |
標頭 | adshlp.h |
程式庫 | Activeds.lib |
Dll | Activeds.dll |