PullConformantInstances method of the MSFTSM_RegisteredProfile class

Continues an enumeration session that is opened by the OpenConformantInstances method.

This method is inherited from the CIM_RegisteredProfile class.

Syntax

uint32 PullConformantInstances(
  [in]      uint32  MaxObjectCount,
  [in, out] string  EnumerationContext,
  [out]     boolean EndOfSequence,
  [out]     uint16  InstanceType[],
  [out]     string  InstanceWithPathList[]
);

Parameters

MaxObjectCount [in]

Specifies the maximum number of elements to be returned. If set to zero the operation timeout clock for the session is reset, but no elements are retrieved.

EnumerationContext [in, out]

On input, specifies the enumeration session context that identifies the session to query.

On return, indicates the enumeration session context.

Set to NULL if the session is closed. If not NULL, this value is used to identify the session on subsequent calls to the PullConformantInstances and CloseConformantInstances methods.

EndOfSequence [out]

On return, indicates whether the enumeration session is exhausted.

If True, no more elements are available and the session is closed. If false, additional elements might be available, and the session remains open.

InstanceType [out]

On return, indicates the type of instance in the corresponding entry in the InstanceWithPathList array.

The possible values are.

Central Instance (2)

Scoping Instance (3)

Central and Scoping Instance (4)

DMTF Reserved

5 = *value*

InstanceWithPathList [out]

On return, contains an unordered set of the requested instances and their addresses. This array is correlated to the InstanceType array.

Returning an array with no entries does not indicate that the enumeration session has been exhausted. Only the EndOfSequence output parameter indicates whether the enumeration session has been exhausted.

Return value

Returns zero on success; otherwise returns an error.

Requirements

Minimum supported client
None supported
Minimum supported server
Windows Server 2012 R2
Namespace
Root\Interop
MOF
SmIscsiTarget.mof
DLL
SmIScsiTargetProv.dll

See also

MSFTSM_RegisteredProfile