Share via

IDebugFunctionObject::CreateArrayObject

  • Article

Applies to: yesVisual Studio noVisual Studio for Mac

Note

This article applies to Visual Studio 2017. If you're looking for the latest Visual Studio documentation, see Visual Studio documentation. We recommend upgrading to the latest version of Visual Studio. Download it here

Creates an array object. This array can contain either primitive or object instance values.

Syntax

HRESULT CreateArrayObject( 
   OBJECT_TYPE    ot,
   IDebugField*   pClassField,
   DWORD          dwRank,
   DWORD          dwDims[],
   DWORD          dwLowBounds[],
   IDebugObject** ppObject
);

int CreateArrayObject(
   enum_OBJECT_TYPE ot,
   IDebugField      pClassField,
   uint             dwRank,
   uint[]           dwDims,
   uint[]           dwLowBounds,
   out IDebugObject ppObject
);

Parameters

ot
[in] Specifies a value from the OBJECT_TYPE enumeration indicating the type of the new array object.

pClassField
[in] An IDebugField object representing the class of an object, if creating an array of object instance values. If creating an array of primitive objects, this parameter is a null value.

dwRank
[in] The rank or number of dimensions of the array.

dwDims
[in] The sizes of each dimension of the array.

dwLowBounds
[in] The origin of each dimension (typically 0 or 1).

ppObject
[out] Returns an IDebugObject object representing the newly created array. This is actually an IDebugArrayObject object.

Return Value

If successful, returns S_OK; otherwise, returns an error code.

Remarks

Call this method to create an object that represents an array parameter to the function which is represented by the IDebugFunctionObject interface.

See also