Export (0) Print
Expand All

IEnumWbemClassObject::Skip method

You can use the IEnumWbemClassObject::Skip method to move the current position in an enumeration ahead by a specified number of objects. Also, this affects subsequent calls to NextAsync, but it does not affect pending deliveries begun with NextAsync.

Syntax


HRESULT Skip(
  [in]  LONG lTimeOut,
  [in]  ULONG UCount
);

Parameters

lTimeOut [in]

Maximum amount of time in milliseconds that the call to Skip blocks before returning. If you use the constant WBEM_INFINITE (0xFFFFFFFF), the call blocks until the operation succeeds. If Skip cannot complete the operation before the lTimeout value expires, the call returns WBEM_S_TIMEDOUT.

UCount [in]

Number of objects to skip. If this parameter is greater than the number of objects left to enumerate, then this call skips to the end of the enumeration and WBEM_S_FALSE is returned.

Return value

This method returns an HRESULT indicating the status of the method call. The following table lists the value contained within an HRESULT.

Return codeDescription
WBEM_E_INVALID_PARAMETER

The caller passes an invalid parameter.

WBEM_E_OUT_OF_MEMORY

There was not enough memory to complete the operation.

WBEM_S_FALSE

The call skips less objects than specified by the uCount parameter value.

WBEM_S_NO_ERROR

The call succeeds and the current position in the enumeration was updated.

WBEM_S_TIMEDOUT

The lTimeout parameter value specified expired before Skip could complete the operation.

WBEM_E_TRANSPORT_FAILURE

This indicates the failure of the remote procedure call (RPC) link between the current process and Windows Management.

WBEM_E_FAILED

An unspecified error occurred.

 

Remarks

COM-specific error codes may also be returned if network problems cause you to lose the remote connection to Windows Management.

Requirements

Minimum supported client

Windows Vista

Minimum supported server

Windows Server 2003

Header

Wbemcli.h (include Wbemidl.h)

Library

Wbemuuid.lib

DLL

Fastprox.dll

 

 

Show:
© 2014 Microsoft