ISymUnmanagedWriter::DefineLocalVariable Method

Defines a single variable in the current lexical scope. This method can be called multiple times for a variable of the same name that has multiple homes throughout a scope. In this case, however, the values of the startOffset and endOffset parameters must not overlap.

HRESULT DefineLocalVariable(
    [in] const WCHAR  *name,
    [in] ULONG32      attributes,
    [in] ULONG32      cSig,
    [in, size_is(cSig)] unsigned char signature[],
    [in] ULONG32      addrKind,
    [in] ULONG32      addr1,
    [in] ULONG32      addr2,
    [in] ULONG32      addr3,
    [in] ULONG32      startOffset,
    [in] ULONG32      endOffset);

Parameters

• name
  [in] A pointer to a WCHAR that defines the local variable name.

• attributes
  [in] The local variable attributes.

• cSig
  [in] A ULONG32 that indicates the size, in bytes, of the signature buffer.

• signature
  [in] The local variable signature.

• addrKind
  [in] The address type.

• addr1
  [in] The first address for the parameter specification.

• addr2
  [in] The second address for the parameter specification.

• addr3
  [in] The third address for the parameter specification.

• startOffset
  [in] The start offset for the variable. This parameter is optional. If it is 0, this parameter is ignored and the variable is defined throughout the entire scope. If it is a nonzero value, the variable falls within the offsets of the current scope.

• endOffset
  [in] The end offset for the variable. This parameter is optional. If it is 0, this parameter is ignored and the variable is defined throughout the entire scope. If it is a nonzero value, the variable falls within the offsets of the current scope.

Return Value

S_OK if the method succeeds; otherwise, E_FAIL or some other error code.

Requirements

Header: CorSym.idl

See Also

Concepts

ISymUnmanagedWriter Interface

ISymUnmanagedWriter::DefineGlobalVariable Method

ISymUnmanagedWriter2::DefineLocalVariable2 Method