IInkDisp::CreateStrokes

4/8/2010

Creates a new IInkStrokes collection for and IInkDisp object from existing IInkStrokeDisp objects.

Syntax

HRESULT CreateStrokes (
  [in, optional, defaultvalue(0)] VARIANT ids,
  [out, retval] IInkStrokes** strokes
);

Parameters

  • ids
    [in, optional] Specifies an array of stroke IDs that exist in the IInkDisp object. The strokes with these IDs are added to a new IInkStrokes collection. The default value is NULL.

    For more information about the VARIANT structure, see Using the Automation Library with Windows Mobile Ink.

  • strokes
    [out, retval] Returns a new IInkStrokes collection.

Return Value

  • S_OK
    Success.
  • E_POINTER
    A parameter contained an invalid pointer.
  • E_INVALIDARG
    Invalid VARIANT type (only VT_ARRAY | VT_I4 supported).
  • E_INK_EXCEPTION
    An exception occurred inside the method.
  • E_OUTOFMEMORY
    Cannot allocate memory to create the new IInkStrokes collection.
  • TPC_E_INVALID_STROKE
    Stroke IDs that do not exist were passed to the method.

Remarks

If the ids parameter is NULL or an empty array, then an empty IInkStrokes collection is created.

Requirements

Header msinkaut.h
Windows Embedded CE Windows CE 5.0 and later
Windows Mobile Windows Mobile 6 Classic and later, Windows Mobile 6 Professional and later

See Also

Concepts

Windows Mobile Ink Reference