ICorProfilerInfo2::GetStringLayout Method

Gets information about the layout of a string object.

HRESULT GetStringLayout(
    [out] ULONG *pBufferLengthOffset,
    [out] ULONG *pStringLengthOffset,
    [out] ULONG *pBufferOffset);

Parameters

Parameter Description

pBufferLengthOffset

[out] A pointer to the offset of the location, relative to the ObjectID pointer, that stores the length of the string's buffer. The length is stored as a DWORD.

PStringLengthOffset

[out] A pointer to the offset of the location, relative to the ObjectID pointer, that stores the length of the string itself. The length is stored as a DWORD.

pBufferOffset

[out] A pointer to the offset of the buffer, relative to the ObjectID pointer, that stores the string of wide characters.

Remarks

The GetStringLayout method gets the offsets, relative to the ObjectID pointer, of the locations in which the following are stored.

  • The length of the string's buffer.

  • The length of the string itself.

  • The buffer containing the actual string of wide characters.

Strings may or may not be null-terminated.

Requirements

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

Header: CorProf.idl

Library: CorGuids.lib

.NET Framework Version: 2.0

See Also

Reference

ICorProfilerInfo Interface
ICorProfilerInfo2 Interface