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-2012, Intel Corporation. All rights reserved. |