Share via


IMetaDataImport::FindField Method

Gets a pointer to the FieldDef token for the field that is enclosed by the specified Type and that has the specified name and metadata signature.

HRESULT FindField (
      [in]  mdTypeDef         td,
      [in]  LPCWSTR           szName,
      [in]  PCCOR_SIGNATURE   pvSigBlob,
      [in]  ULONG             cbSigBlob,
      [out] mdFieldDef        *pmb
);

Parameters

  • td
    [in] The TypeDef token for the class or interface that encloses the field to search for. If this value is mdTokenNil, the lookup is done for a global variable.

  • szName
    [in] The name of the field to search for.

  • pvSigBlob
    [in] A pointer to the binary metadata signature of the field.

  • cbSigBlob
    [in] The size in bytes of pvSigBlob.

  • pmb
    [out] A pointer to the matching FieldDef token.

Remarks

You specify the field using its enclosing class or interface (td), its name (szName), and optionally its signature (pvSigBlob).

The signature passed to FindField must have been generated in the current scope, because signatures are bound to a particular scope. A signature can embed a token that identifies the enclosing class or value type. (The token is an index into the local TypeDef table). You cannot build a run-time signature outside the context of the current scope and use that signature as input to FindField.

FindField finds only fields that were defined directly in the class or interface; it does not find inherited fields.

Requirements

Platforms: Windows 2000, Windows XP, Windows Server 2003 family

Header: Cor.h

Library: Included as a resource in MsCorEE.dll

.NET Framework Version: 2.0, 1.1, 1.0

See Also

Concepts

IMetaDataImport Interface

IMetaDataImport2 Interface