System::Runtime::InteropServices::Marshal Class Reference

Static Public Member Functions
template<typename container >
static void	Copy (const IntPtr source, container &&destination, int startIndex, int length)
template<typename container >
static void	Copy (const void *source, container &&destination, int startIndex, int length)
template<typename container >
static void	Copy (const container &source, int startIndex, void *destination, int length)
template<typename container >
static void	Copy (const container &source, int startIndex, IntPtr destination, int length)
static void	WriteByte (IntPtr ptr, int offset, uint8_t value)
static void	WriteByte (IntPtr ptr, uint8_t value)
static void	WriteInt16 (IntPtr ptr, int offset, int16_t value)
static void	WriteInt32 (IntPtr ptr, int offset, int32_t value)
static void	WriteInt64 (IntPtr ptr, int offset, int64_t value)
static uint8_t	ReadByte (IntPtr ptr, int offset=0)
static int16_t	ReadInt16 (IntPtr ptr, int offset=0)
static int32_t	ReadInt32 (IntPtr ptr, int offset=0)
static int32_t	GetHRForException (const System::Exception &exc)
static ASPOSECPP_SHARED_API IntPtr	SecureStringToGlobalAllocAnsi (const SharedPtr< Security::SecureString > &s)
static ASPOSECPP_SHARED_API IntPtr	SecureStringToGlobalAllocUnicode (const SharedPtr< Security::SecureString > &s)
static ASPOSECPP_SHARED_API IntPtr	AllocHGlobal (int32_t bytes_count)
static ASPOSECPP_SHARED_API IntPtr	AllocHGlobal (IntPtr bytes_count)
static ASPOSECPP_SHARED_API void	FreeHGlobal (IntPtr address)
static ASPOSECPP_SHARED_API void	ZeroFreeGlobalAllocAnsi (IntPtr s)
static ASPOSECPP_SHARED_API void	ZeroFreeGlobalAllocUnicode (IntPtr s)
static ASPOSECPP_SHARED_API IntPtr	StringToHGlobalAnsi (const String &s)
static ASPOSECPP_SHARED_API IntPtr	StringToHGlobalUni (const String &s)
static ASPOSECPP_SHARED_API IntPtr	StringToHGlobalAuto (const String &s)
static ASPOSECPP_SHARED_API String	PtrToStringAnsi (IntPtr ptr)
static ASPOSECPP_SHARED_API String	PtrToStringAnsi (IntPtr ptr, int length)
static ASPOSECPP_SHARED_API String	PtrToStringAuto (IntPtr ptr)
static ASPOSECPP_SHARED_API String	PtrToStringAuto (IntPtr ptr, int length)
static ASPOSECPP_SHARED_API String	PtrToStringUni (IntPtr ptr)
static ASPOSECPP_SHARED_API String	PtrToStringUni (IntPtr ptr, int length)
static ASPOSECPP_SHARED_API String	PtrToStringUTF8 (IntPtr ptr)
static ASPOSECPP_SHARED_API String	PtrToStringUTF8 (IntPtr ptr, int length)

Detailed Description

Provides marshalling implementation. For compatibility with translated code only, as no managed code is supported on C++ side. This is a static type with no instance services. You should never create instances of it by any means.

Member Function Documentation

AllocHGlobal() [1/2]

static ASPOSECPP_SHARED_API IntPtr System::Runtime::InteropServices::Marshal::AllocHGlobal ( int32_t  bytes_count )

static

Allocates unmanaged memory.

Parameters

bytes_count

Required number of bytes.

Returns

Pointer to the allocated memory.

AllocHGlobal() [2/2]

static ASPOSECPP_SHARED_API IntPtr System::Runtime::InteropServices::Marshal::AllocHGlobal ( IntPtr  bytes_count )

static

Allocates unmanaged memory.

Parameters

bytes_count

Required number of bytes.

Returns

Pointer to the allocated memory.

Copy() [1/4]

template<typename container >

static void System::Runtime::InteropServices::Marshal::Copy ( const IntPtr  source, container &&  destination, int  startIndex, int  length  )

inlinestatic

Implements public static void Copy(IntPtr source, byte[] destination, int startIndex, int length) semantics.

Template Parameters

container

Destination container type.

Parameters

source	Source data pointer.
destination	Container to copy data into.
startIndex	Source start index.
length	Number of elements to copy.

Copy() [2/4]

template<typename container >

static void System::Runtime::InteropServices::Marshal::Copy ( const void *  source, container &&  destination, int  startIndex, int  length  )

inlinestatic

Implements public static void Copy(IntPtr source, byte[] destination, int startIndex, int length) semantics.

Template Parameters

container

Destination container type.

Parameters

source	Source data pointer.
destination	Container to copy data into.
startIndex	Source start index.
length	Number of elements to copy.

Copy() [3/4]

template<typename container >

static void System::Runtime::InteropServices::Marshal::Copy ( const container &  source, int  startIndex, void *  destination, int  length  )

inlinestatic

Implements public static void Copy(char[] source, int startIndex, IntPtr destination, int length).

Template Parameters

container

Source container type.

Parameters

source	Source data pointer.
startIndex	Source start index.
destination	Destination data pointer.
length	Number of elements to copy.

Copy() [4/4]

template<typename container >

static void System::Runtime::InteropServices::Marshal::Copy ( const container &  source, int  startIndex, IntPtr  destination, int  length  )

inlinestatic

Implements public static void Copy(char[] source, int startIndex, IntPtr destination, int length).

Template Parameters

container

Source container type.

Parameters

source	Source data pointer.
startIndex	Source start index.
destination	Destination data pointer.
length	Number of elements to copy.

FreeHGlobal()

static ASPOSECPP_SHARED_API void System::Runtime::InteropServices::Marshal::FreeHGlobal ( IntPtr  address )

static

Frees unmanaged memory.

Parameters

address

Pointer to the allocated memory.

GetHRForException()

static int32_t System::Runtime::InteropServices::Marshal::GetHRForException ( const System::Exception &  exc )

inlinestatic

Gets HResult from exception.

Parameters

exc	Exception to get HResult for.

Returns

HResult value.

PtrToStringAnsi() [1/2]

static ASPOSECPP_SHARED_API String System::Runtime::InteropServices::Marshal::PtrToStringAnsi ( IntPtr  ptr )

static

Creates a managed String from an unmanaged zero-terminated UTF8-string.

Parameters

ptr	Pointer to the unmanaged string.

Returns

A managed string.

PtrToStringAnsi() [2/2]

static ASPOSECPP_SHARED_API String System::Runtime::InteropServices::Marshal::PtrToStringAnsi ( IntPtr  ptr, int  length  )

static

Creates a managed String from an unmanaged UTF8-string.

Parameters

ptr	Pointer to the unmanaged string.
length	Length of the unmanaged string.

Returns

A managed string.

PtrToStringAuto() [1/2]

static ASPOSECPP_SHARED_API String System::Runtime::InteropServices::Marshal::PtrToStringAuto ( IntPtr  ptr )

static

Creates a managed String from an unmanaged zero-terminated string.

Parameters

ptr	Pointer to the unmanaged string.

Returns

A managed string.

PtrToStringAuto() [2/2]

static ASPOSECPP_SHARED_API String System::Runtime::InteropServices::Marshal::PtrToStringAuto ( IntPtr  ptr, int  length  )

static

Creates a managed String from an unmanaged string.

Parameters

ptr	Pointer to the unmanaged string.
length	Length of the unmanaged string.

Returns

A managed string.

PtrToStringUni() [1/2]

static ASPOSECPP_SHARED_API String System::Runtime::InteropServices::Marshal::PtrToStringUni ( IntPtr  ptr )

static

Creates a managed String from an unmanaged zero-terminated unicode string.

Parameters

ptr	Pointer to the unmanaged string.

Returns

A managed string.

PtrToStringUni() [2/2]

static ASPOSECPP_SHARED_API String System::Runtime::InteropServices::Marshal::PtrToStringUni ( IntPtr  ptr, int  length  )

static

Creates a managed String from an unmanaged unicode string.

Parameters

ptr	Pointer to the unmanaged string.
length	Length of the unmanaged string.

Returns

A managed string.

PtrToStringUTF8() [1/2]

static ASPOSECPP_SHARED_API String System::Runtime::InteropServices::Marshal::PtrToStringUTF8 ( IntPtr  ptr )

static

Creates a managed String from an unmanaged zero-terminated UTF8-string.

Parameters

ptr	Pointer to the unmanaged string.

Returns

A managed string.

PtrToStringUTF8() [2/2]

static ASPOSECPP_SHARED_API String System::Runtime::InteropServices::Marshal::PtrToStringUTF8 ( IntPtr  ptr, int  length  )

static

Creates a managed String from an unmanaged UTF8-string.

Parameters

ptr	Pointer to the unmanaged string.
length	Length of the unmanaged string.

Returns

A managed string.

ReadByte()

static uint8_t System::Runtime::InteropServices::Marshal::ReadByte ( IntPtr  ptr, int  offset = 0  )

inlinestatic

Reads byte from memory.

Parameters

ptr	Memory buffer.
offset	Offset to memory buffer.

Returns

Read value.

ReadInt16()

static int16_t System::Runtime::InteropServices::Marshal::ReadInt16 ( IntPtr  ptr, int  offset = 0  )

inlinestatic

Reads short from memory.

Parameters

ptr	Memory buffer.
offset	Offset to memory buffer.

Returns

Read value.

ReadInt32()

static int32_t System::Runtime::InteropServices::Marshal::ReadInt32 ( IntPtr  ptr, int  offset = 0  )

inlinestatic

Reads int from memory.

Parameters

ptr	Memory buffer.
offset	Offset to memory buffer.

Returns

Read value.

SecureStringToGlobalAllocAnsi()

static ASPOSECPP_SHARED_API IntPtr System::Runtime::InteropServices::Marshal::SecureStringToGlobalAllocAnsi ( const SharedPtr< Security::SecureString > &  s )

static

Copies contents of specified secure string into unmanaged memory, converting into ANSI format.

Parameters

s	Secure string.

Returns

The address in unmanaged memory.

SecureStringToGlobalAllocUnicode()

static ASPOSECPP_SHARED_API IntPtr System::Runtime::InteropServices::Marshal::SecureStringToGlobalAllocUnicode ( const SharedPtr< Security::SecureString > &  s )

static

Copies contents of specified secure string into unmanaged memory.

Parameters

s	Secure string.

Returns

The address in unmanaged memory.

StringToHGlobalAnsi()

static ASPOSECPP_SHARED_API IntPtr System::Runtime::InteropServices::Marshal::StringToHGlobalAnsi ( const String &  s )

static

Copies the contents of a specified string into unmanaged memory.

Parameters

s	A string to be copied.

Returns

The address, in unmanaged memory.

StringToHGlobalAuto()

static ASPOSECPP_SHARED_API IntPtr System::Runtime::InteropServices::Marshal::StringToHGlobalAuto ( const String &  s )

static

Copies the contents of a specified string into unmanaged memory, converting to ANSI format if required.

Parameters

s	A string to be copied.

Returns

The address, in unmanaged memory.

StringToHGlobalUni()

static ASPOSECPP_SHARED_API IntPtr System::Runtime::InteropServices::Marshal::StringToHGlobalUni ( const String &  s )

static

Copies the contents of a specified string into unmanaged memory.

Parameters

s	A string to be copied.

Returns

The address, in unmanaged memory.

WriteByte() [1/2]

static void System::Runtime::InteropServices::Marshal::WriteByte ( IntPtr  ptr, int  offset, uint8_t  value  )

inlinestatic

Writes byte to memory.

Parameters

ptr	Memory buffer.
offset	Offset to memory buffer.
value	to write.

WriteByte() [2/2]

static void System::Runtime::InteropServices::Marshal::WriteByte ( IntPtr  ptr, uint8_t  value  )

inlinestatic

Writes byte to memory.

Parameters

ptr	Memory buffer.
value	to write.

WriteInt16()

static void System::Runtime::InteropServices::Marshal::WriteInt16 ( IntPtr  ptr, int  offset, int16_t  value  )

inlinestatic

Writes short to memory.

Parameters

ptr	Memory buffer.
offset	Offset to memory buffer.
value	to write.

WriteInt32()

static void System::Runtime::InteropServices::Marshal::WriteInt32 ( IntPtr  ptr, int  offset, int32_t  value  )

inlinestatic

Writes int to memory.

Parameters

ptr	Memory buffer.
offset	Offset to memory buffer.
value	to write.

WriteInt64()

static void System::Runtime::InteropServices::Marshal::WriteInt64 ( IntPtr  ptr, int  offset, int64_t  value  )

inlinestatic

Writes long to memory.

Parameters

ptr	Memory buffer.
offset	Offset to memory buffer.
value	to write.

ZeroFreeGlobalAllocAnsi()

static ASPOSECPP_SHARED_API void System::Runtime::InteropServices::Marshal::ZeroFreeGlobalAllocAnsi ( IntPtr  s )

static

Frees unmanaged string pointer that was allocated using the SecureStringToGlobalAllocAnsi method.

Parameters

s	Pointer to the unmanaged string.

ZeroFreeGlobalAllocUnicode()

static ASPOSECPP_SHARED_API void System::Runtime::InteropServices::Marshal::ZeroFreeGlobalAllocUnicode ( IntPtr  s )

static

Frees unmanaged string pointer that was allocated using the SecureStringToGlobalAllocUnicode method.

Parameters

s	Pointer to the unmanaged string.