EN
このコンテンツは設定された言語で表示できません。英語版のページが表示されます。

MI_Context_WriteStreamParameter function

Sends streamed parameter data to the client for a method invocation.

Syntax


 MI_INLINE MI_Result MI_INLINE_CALL MI_Context_WriteStreamParameter(
  _In_  MI_Context *self,
  _In_  const MI_Char *name,
  _In_  const MI_Value *value,
  _In_  MI_Type type,
  _In_  MI_Uint32 flags
);

Parameters

self [in]

Request context.

name [in]

A null-terminated string that represents the name of the method parameter to stream.

value [in]

A value-type entity.

type [in]

MI_Type object that indicates the type being streamed.

flags [in]

Must be 0 or MI_FLAG_NULL.

ValueMeaning
MI_FLAG_NULL
0x1000000

The end of the stream has been reached.

 

Return value

A value of the MI_Result enumeration that specifies the function return code. This can be one of the following codes.

Return codeDescription
MI_RESULT_OK

The operation succeeded.

MI_RESULT_SERVER_LIMITS_EXCEEDED

There is not enough memory to complete the request.

MI_RESULT_INVALID_PARAMETER

One or more parameters passed to the function were not valid.

MI_RESULT_FAILED

A failure not covered by other MI_Result error codes.

 

Remarks

Array-method out parameters can be marked as streamed, which means that instead of sending all out parameters in one chunk they are streamed to the client. Streamed parameter data enables the client to display data in a smoother fashion rather than having to wait until all of the data has been sent. This gives the user interface a smoother, more consistent feel. The value can be an array that contains one or more elements of the specified type. Call this function repeatedly to send the entire stream. If the client does not handle streamed parameters, the server will cache all the results and send them to the client at once. In the case of the results being cached when large result sets are generated, the provider may exceed quotas and be shutdown, meaning that methods that generate very large result sets may work only with clients that support streaming.

Requirements

Minimum supported client

Windows 8

Minimum supported server

Windows Server 2012

Redistributable

Windows Management Framework 3.0 on Windows Server 2008 R2 with SP1, Windows 7 with SP1, and Windows Server 2008 with SP2

Header

Mi.h

See also

MI_Context
MI_Type

 

 

表示:
© 2014 Microsoft