IWMSPacket::InsertBuffer

banner art

Previous Next

IWMSPacket::InsertBuffer

The InsertBuffer method inserts a new buffer immediately following the buffer at the specified index.

Syntax

  HRESULT InsertBuffer(
  
  );

Parameters

dwBufferNum

[in] DWORD containing the index at which to insert the new buffer. A value of -1 indicates that the new buffer will be inserted at the end of the list.

ppBuffer

[in] Pointer to an INSSBuffer interface containing the buffer to insert.

pdwBufferOffset

[in] DWORD containing the offset into the buffer list.

pdwBufferLen

[in] DWORD containing the length of the buffer.

pwFlags

[in] Member of the WMS_PACKET_BUFFER_FLAGS enumeration type. This must be set to the following value.

Value Description
WMS_INSERT_BUFFER_AT_END The buffer should be inserted at the end of the list.

dwExFlags

[in] Member of the WMS_PACKET_BUFFER_EX_FLAGS enumeration type. This must be a bitwise OR of one or more of the following values.

Value Description
WMS_BUFFER_COMBINE This buffer should be combined with the list rather than appended.
WMS_BUFFER_NO_ADDREF The reference count for the buffer should not be incremented.
WMS_BUFFER_NO_REFCOUNT No reference count should be kept for this buffer.
WMS_BUFFER_NO_RELEASE The buffer should not be released regardless of reference count.

Return Values

If the method succeeds, it returns S_OK. If it fails, it returns an HRESULT error code.

Return code Number Description
E_INVALIDARG 0x80070057 dwBufferNum is not a valid index location.
E_OUTOFMEMORY 0x8007000E There is insufficient memory to complete the function.

Requirements

Header: wmspacket.h.

Library: WMSServerTypeLib.dll.

Platform: Windows Server 2003, Enterprise Edition; Windows Server 2003, Datacenter Edition; Windows Server 2008.

See Also

Previous Next