IWMSPacket::InsertBuffer
.gif)
| 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 |