Edit

Share via

IInkExtendedProperties::Add method (msinkaut.h)

  • Article

Creates and adds an IInkExtendedProperty object to the IInkExtendedProperties collection.

Syntax

HRESULT Add(
  [in]          BSTR                 Guid,
  [in]          VARIANT              Data,
  [out, retval] IInkExtendedProperty **InkExtendedProperty
);

Parameters

[in] Guid

The name of the new IInkExtendedProperty object. The name is expressed as a BSTR that represents the globally unique identifier (GUID) in the following format:

{dfc71f44-354b-4ca1-93d7-7459410b6343} (Including curly braces)

For more information about the BSTR data type, see Using the COM Library.

[in] Data

The data for the new IInkExtendedProperty object.

For more information about the VARIANT structure, see Using the COM Library.

[out, retval] InkExtendedProperty

When this method returns, contains a pointer to the new extended property.

Return value

This method can return one of these values.

Return code Description
S_OK
 Success.
E_POINTER
 A parameter contained an invalid pointer.
E_INVALIDARG
 The user did not specify data.
CO_E_CLASSSTRING
 Invalid GUID format.
E_INK_EXCEPTION
 An exception occurred inside the method.
TPC_E_INVALID_STROKE
 The stroke is invalid.

Remarks

Note  You cannot store an empty IInkExtendedProperty object. The object must contain data before it can be stored. For example, if you try to add extended properties to a stroke for later use, an exception is thrown if the extended property contains no data.
 
The following types are acceptable:
  • Byte or CHAR array
  • Arrays of integers, floats, large integers, doubles, dates, or decimals
  • Booleans (but not arrays of Booleans)
  • BSTRs (but not arrays of BSTRs)
  • Arrays of Variants. All arrays of variants passed as an IInkExtendedProperty must be of the same type and be all numeric. For example, variant arrays of BSTRS, arrays of arrays, VT_NULL and VT_EMPTY are not supported.
Note  If you call this method with the Guid parameter set to a GUID that already exists in the IInkExtendedProperties collection, the new data will replace the existing extended property for that GUID instead of adding a second element.
 

Requirements

Requirement Value
Minimum supported client Windows XP Tablet PC Edition [desktop apps only]
Minimum supported server None supported
Target Platform Windows
Header msinkaut.h
Library InkObj.dll

See also

IInkExtendedProperties Interface

InkStrokes Collection