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

 

 

Show: