Pull

This function retrieves a list of names of machines corresponding to the enumeration specified by the enumeration context.

Header

void Pull (

    [in] uint EnumerationContext

    [in] uint MaxElements

    [out] SystemsResponse Items

    [out] bool EndOfSequence

);

Parameters

Parameter

Description

EnumerationContext

The required EnumerationContext element contains the enumeration context received from the EnumerateConnectedMachines method.

MaxElements

This optional element indicates the number of items the consumer is willing to accept. When this element is absent, its implied value is 1. Implementations MUST NOT return more than this number of elements in the Pull response message. Implementations MAY return fewer than this number based on either the MaxTime timeout, or implementation-specific constraints.

Items

The optional Items element contains one or more names of connected machines.

EndOfSequence

This optional element indicates that no more elements are available from this enumeration. Additionally, once this element is returned in a Pull response message, the enumeration context becomes invalid, and subsequent Pull requests using that enumeration context SHOULD generate an InvalidEnumerationContext fault message; in any case, they MUST NOT return a valid PullResponse.

 

The command returns at least one of the optional Items or EndOfSequence parameters. It is possible for both to appear if items are returned and the sequence is exhausted.

Return Values

The command may return the following SOAP Fault:

Code

Description

RET_INVALID_ENUMERATION_CONTEXT

An invalid enumeration context has been passed as a parameter. This may occur if the enumeration context returned by the EnumerateConnectedMachines was not used when invoking the Pull command.

 

See Also:

   EnumerateConnectedMachines Command

   Release

 

Copyright © 2006-2022, Intel Corporation. All rights reserved.