Edit

Share via

IXCLRDataValue::StartEnumFieldsByName Method

  • Article

Provides a handle to enumerate the fields of the value by name.

Note

This API was originally designed for internal use in the runtime. Although it is now supported for 3rd party use, we recommend working with ICorDebug and ICorProfiler APIs when possible.

Syntax

HRESULT StartEnumFieldsByName(
    [in] LPCWSTR name,
    [in] ULONG32 nameFlags,
    [in] ULONG32 fieldFlags,
    [in] IXCLRDataTypeInstance *fromType,
    [out] CLRDATA_ENUM *handle
);

Parameters

name
[in] The name for which to enumerate matching fields

nameFlags
[in] A set of flags defining how to match name against field names. This is one of the behaviors defined in the CLRDataByNameFlag enumeration.

fieldFlags
[in] A set of flags defining which fields to enumerate. This is one or more of the flags defined in the CLRDataFieldFlag enumeration.

fromType
[in] If provided, only fields defined in this type are enumerated.

handle
[out] A handle for enumerating the fields by name as specified by the other arguments to this method.

Remarks

The provided method is part of the IXCLRDataValue interface and corresponds to the 17th slot of the virtual method table.

Requirements

Platforms: See System Requirements.
Header: None
Library: None
.NET Framework Versions: Available since 4.7

See also