IPacket

项目
08/18/2008

更新：2007 年 11 月

保存数据并由实现 IDevicePacketStream 的对象用于在设备代理应用程序和台式计算机之间传输数据。

IPacket : public IUnknown

方法

方法	说明
IPacket::get_Count	获取数据包中数据对象的总数。
IPacket::IsEndOfPacket	检查内部迭代器是否已到达数据包的末尾。
IPacket::ReadBool	从对象中读取一个布尔值，并使内部迭代器指向数据包中的下一个数据对象。
IPacket::ReadByte	从对象中读取一个字节，并使内部迭代器指向数据包中的下一个数据对象。
IPacket::ReadBytes	从对象中读取一个字节数组，并使内部迭代器指向数据包中的下一个数据对象。
IPacket::ReadInt32	从对象中读取一个整数，并使内部迭代器指向数据包中的下一个数据对象。
IPacket::ReadChar	从对象中读取一个字符，并使内部迭代器指向数据包中的下一个数据对象。
IPacket::ReadDataType	以枚举值的形式返回数据包中当前对象的数据类型。
IPacket::ReadString	从对象中读取一个字符串，并使内部迭代器指向数据包中的下一个数据对象。
IPacket::Reset	将数据包的内部迭代器重置为指向数据包中的第一个数据对象。下一个读取操作将读取数据包中的第一个数据对象。
IPacket::WriteBool	向对象中写入一个布尔值。
IPacket::WriteByte	向对象中写入一个字节。
IPacket::WriteBytes	向对象中写入一个字节数组。
IPacket::WriteChar	向对象中写入一个字符。
IPacket::WriteInt32	向对象中写入一个整数。
IPacket::WriteString	向对象中写入一个字符串。

备注

若要获取实现此接口的对象，请使用 GetNewPacket。

实现此接口的对象只能保存 byte、byte[]、string、int 和 char 类型的对象。它不能扩展为读写自定义对象。但是，用户仍然可以通过流传输自定义对象，方法是将自定义数据类型拆分为基本数据类型，或者将自定义数据类型序列化为字节数组。

示例

下面的示例是一个设备代理应用程序，它将向台式机写入一个数据包并从台式机读取一个数据包。

#include "stdafx.h"

// Custom implementation of IAgentTransportShutdownCallback
class MyShutdownCallback: public IAgentTransportShutdownCallback
{
private:
    long ref;
public:
    HRESULT STDMETHODCALLTYPE Shutdown(IUnknown *in_pUnknown) 
    {
        // Add your cleanup code here 
        MessageBox(NULL,_T("conmanclient2 exited"),_T("conmanclient exited"),0);
        return 0;
    }

    // Must implement members from IUnknown
    HRESULT STDMETHODCALLTYPE QueryInterface( REFIID riid, void __RPC_FAR *__RPC_FAR *ppvObject)
    {
        return 0;
    }
    ULONG STDMETHODCALLTYPE AddRef( void)
    {
        return InterlockedIncrement(&ref);
    }

    ULONG STDMETHODCALLTYPE Release( void)
    {
        if(InterlockedDecrement(&ref) == 0)
        {
            delete this;
            return 0;
        }
        return ref;
    }
};

int _tmain(int argc, _TCHAR* argv[])
{
    // Load the Device Agent Transport Library
    HINSTANCE hmod;
    hmod = LoadLibrary(L"DeviceAgentTransport.dll");

    // Get an instance of IDeviceAgentTransport
    GetDeviceAgentTransportFunc f1 = (GetDeviceAgentTransportFunc)
        ::GetProcAddress(hmod, L"GetDeviceAgentTransport");
    IDeviceAgentTransport *pTransport = NULL;
    f1(&pTransport);

    // Register the callback with the Device Agent Transport
    MyShutdownCallback *shutdownCallback = new MyShutdownCallback();
    pTransport->RegisterShutdownCallback(shutdownCallback,shutdownCallback);

    // Let the desktop application know that this remote agent was deployed successfully 
    // and that this remote agent will handle the supplied list of services.
    LPCOLESTR szServiceIds[] = {L"F85E57BA-5AE9-4FF7-8433-6AB7D991D033"};
    pTransport->AcknowledgeLaunch(1, szServiceIds);

    // Open a communcation stream with desktop application on the service.
    IDevicePacketStream *pStream = NULL;
    pTransport->AcceptConnectionEx(szServiceIds[0], &pStream);

    // Get an instance of IPacket
    GetNewPacketFunc f2 = (GetNewPacketFunc) ::  GetProcAddress(hmod, L"GetNewPacket");
    IPacket *pPacket = NULL;
    f2(&pPacket);

    // Write a message and sent the packet.
    pPacket->WriteBool(true);
    pPacket->WriteByte(0xff);
    pPacket->WriteChar('c');
    pPacket->WriteInt32(1024);
    pPacket->WriteString(L"Hello Desktop Computer");
    pStream->Write(pPacket);

    // Check for a packet while communication stream is connected.
    f2(&pPacket);
    VARIANT_BOOL connected;
    pStream->IsConnected(&connected);
    while(connected)
    {
        pStream->IsConnected(&connected);
        VARIANT_BOOL available;

        // If a packet is found, display the string.
        pStream->IsPacketAvailable(&available);
        if(available)
        {
            pStream->Read(&pPacket);
            VARIANT_BOOL endofpacket;
            pPacket->IsEndOfPacket(&endofpacket);
            while (!endofpacket) 

            {
                pPacket->IsEndOfPacket(&endofpacket);
                DataTypeEnum datatype;
                pPacket->ReadDataType(&datatype);
                switch (datatype)
                {
                    case DT_BYTE:
                        BYTE byteValue;
                        pPacket->ReadByte(&byteValue);
                        break;
                    case DT_INT32:
                        INT32 intValue;
                        pPacket->ReadInt32(&intValue);
                        break;
                    case DT_WIDECHAR:
                        wchar_t charValue;
                        pPacket->ReadChar(&charValue);
                        break;
                    case DT_BOOL:
                        VARIANT_BOOL boolValue;
                        pPacket->ReadBool(&boolValue);
                        break;
                    case DT_BYTEARRAY:
                        BYTE * buffer[100];
                        ULONG length;
                        pPacket->ReadBytes(buffer,&length);
                        break;
                    case DT_STRING:
                        LPWSTR string;
                        pPacket->ReadString(&string);
                        MessageBox(NULL, string,string,0);
                        break;
                    default:
                        break;
                }
            };
        }
    };
    return 0;
}

通过

IPacket

方法

备注

示例

托管等效项

要求

请参见

其他资源

其他资源