ICorProfilerInfo2::GetStringLayout Method

Gets information about the layout of a string object. This method is deprecated in the .NET Framework version 4, and is superseded by the ICorProfilerInfo3::GetStringLayout2 method.

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

pBufferLengthOffset

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

NoteNote

This parameter returns the length of the string itself, not the length of the buffer. The length of the buffer is no longer available.

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.

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 that contains the actual string of wide characters.

Strings may be null-terminated.

Platforms: See .NET Framework System Requirements.

Header: CorProf.idl, CorProf.h

Library: CorGuids.lib

.NET Framework Versions: 4, 3.5 SP1, 3.5, 3.0 SP1, 3.0, 2.0 SP1, 2.0

Was this page helpful?
(1500 characters remaining)
Thank you for your feedback

Community Additions

ADD
Show:
© 2014 Microsoft