com.sun.jna.platform.win32.COM.IEnumMoniker Maven / Gradle / Ivy

Go to download

Show more of this group Show more artifacts with this name
Show all versions of jna-platform Show documentation

Java Native Access Platform

There is a newer version: 5.17.0

/* Copyright (c) 2014 Dr David H. Akehurst (itemis), All Rights Reserved
 *
 * This library is free software; you can redistribute it and/or
 * modify it under the terms of the GNU Lesser General Public
 * License as published by the Free Software Foundation; either
 * version 2.1 of the License, or (at your option) any later version.
 *
 * This library is distributed in the hope that it will be useful,
 * but WITHOUT ANY WARRANTY; without even the implied warranty of
 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
 * Lesser General Public License for more details.
 */
package com.sun.jna.platform.win32.COM;

import com.sun.jna.ptr.PointerByReference;
import com.sun.jna.platform.win32.Guid.IID;
import com.sun.jna.platform.win32.WinDef.ULONG;
import com.sun.jna.platform.win32.WinDef.ULONGByReference;
import com.sun.jna.platform.win32.WinNT.HRESULT;

/**
 * Enumerates the components of a moniker or the monikers in a table of monikers.
 * 
 * @see MSDN
 *
 */
public interface IEnumMoniker extends IUnknown {

	public final static IID IID = new IID("{00000102-0000-0000-C000-000000000046}");
	
	/**
	 * Creates a new enumerator that contains the same enumeration state as the
	 * current one.
	 * 
	 * This method makes it possible to record a particular point in the
	 * enumeration sequence and then return to that point at a later time. The
	 * caller must release this new enumerator separately from the first
	 * enumerator.
	 * 
	 * {@code
	 *   HRESULT Clone(
	 *     [out]  IEnumMoniker **ppenum
	 *   );
	 * }
	 * 
	 * @see MSDN
	 */
	HRESULT Clone(PointerByReference ppenum);

	/**
	 * Retrieves the specified number of items in the enumeration sequence.
	 * 
	 * Note: The caller is responsible for calling Release through each pointer
	 * enumerated.
	 * 
	 * {@code
	 *   HRESULT Next(
	 *     [in] ULONG celt,
	 *     [out] IMoniker **rgelt,
	 *     [in, out] ULONG *pceltFetched
	 *   );
	 * }
	 * 
	 * @see MSDN
	 * 
	 */
	HRESULT Next(ULONG celt, PointerByReference rgelt, ULONGByReference pceltFetched);

	/**
	 * Resets the enumeration sequence to the beginning.
	 * 
	 * {@code
	 *   HRESULT Reset();
	 * }
	 * 
	 * @see MSDN
	 * 
	 */
	HRESULT Reset();

	/**
	 * Skips over the specified number of items in the enumeration sequence.
	 * 
	 * {@code
	 *   HRESULT Skip(
	 *     [in]  ULONG celt
	 *   );
	 * }
	 * 
	 * @see MSDN
	 * 
	 */
	HRESULT Skip(ULONG celt);
}