upnp.idl

Windows CE 6.0 Server 源码

    HRESULT LastTransportStatus([out, retval] long * plValue);
};


[
    object,
    uuid(24ea2515-f612-4528-ba82-7bd3dbbad303),
    pointer_default(unique)
]
interface IUPnPServiceCallbackPrivate: IUnknown
{
    HRESULT AddTransientCallback([in] IUnknown  * pUnkCallback,
                                 [out] DWORD *pdwCookie);
    HRESULT RemoveTransientCallback([in] DWORD dwCookie);
};


[
    object,
    uuid(31fadca9-ab73-464b-b67d-5c1d0f83c8b8),
    pointer_default(unique)
]
interface IUPnPServiceCallback : IUnknown
{
    HRESULT
    StateVariableChanged([in]   IUPnPService    * pus,
                         [in]   LPCWSTR         pcwszStateVarName,
                         [in]   VARIANT         vaValue);
    HRESULT
    ServiceInstanceDied([in]    IUPnPService    * pus);

};


[
    object,
    uuid(FDBC0C73-BDA3-4C66-AC4F-F2D96FDAD68C),
    dual,
    helpstring("IUPnPDevices Interface"),
    oleautomation,
    pointer_default(unique),
    nonextensible
]
interface IUPnPDevices : IDispatch
{
    [propget, id(DISPID_UPNPDEVICES_COUNT), helpstring("property Count")]
    HRESULT Count([out, retval] long * plCount);

    [propget, id(DISPID_NEWENUM), restricted, hidden, helpstring("property _NewEnum")]
    HRESULT _NewEnum([out, retval] LPUNKNOWN * ppunk);

    [propget, id(DISPID_VALUE), helpstring("property Item")]
    HRESULT Item([in] BSTR bstrUDN,
                 [out, retval] IUPnPDevice ** ppDevice);
};


[
    object,
    uuid(3D44D0D1-98C9-4889-ACD1-F9D674BF2221),
    dual,
    helpstring("IUPnPDevice Interface"),
    oleautomation,
    pointer_default(unique),
    nonextensible
]
interface IUPnPDevice : IDispatch
{
    [propget, id(DISPID_UPNPDEVICE_ISROOTDEVICE),
     helpstring("denotes whether the device is the highest-level device in the device tree")]
    HRESULT IsRootDevice([out, retval] VARIANT_BOOL * pvarb);

    [propget, id(DISPID_UPNPDEVICE_ROOT),
     helpstring("returns the top device in the device tree")]
    HRESULT RootDevice([out, retval] IUPnPDevice ** ppudRootDevice);

    [propget, id(DISPID_UPNPDEVICE_PARENT),
     helpstring("returns the parent of the current device")]
    HRESULT ParentDevice([out, retval] IUPnPDevice ** ppudDeviceParent);

    [propget, id(DISPID_UPNPDEVICE_HASCHILDREN),
     helpstring("denotes whether the current device contains child devices")]
    HRESULT HasChildren([out, retval] VARIANT_BOOL * pvarb);

    [propget, id(DISPID_UPNPDEVICE_CHILDREN),
     helpstring("returns a collection of the children of the current device")]
    HRESULT Children([out, retval] IUPnPDevices ** ppudChildren);

    [propget, id(DISPID_UPNPDEVICE_UDN),
     helpstring("returns the UDN of the device")]
    HRESULT UniqueDeviceName([out, retval] BSTR * pbstr);

    [propget, id(DISPID_UPNPDEVICE_FRIENDLYNAME),
     helpstring("returns the (optional) display name of the device")]
    HRESULT FriendlyName([out, retval] BSTR * pbstr);

    [propget, id(DISPID_UPNPDEVICE_DEVICETYPE),
     helpstring("returns the device type URI")]
    HRESULT Type([out, retval] BSTR * pbstr);

    [propget, id(DISPID_UPNPDEVICE_PRESENTATIONURL),
     helpstring("obtains a presentation URL to a web page that can control the device")]
    HRESULT PresentationURL([out, retval] BSTR * pbstr);

    [propget, id(DISPID_UPNPDEVICE_MANUFACTURERNAME),
     helpstring("displayable manufacturer name")]
    HRESULT ManufacturerName([out, retval] BSTR * pbstr);

    [propget, id(DISPID_UPNPDEVICE_MANUFACTURERURL),
     helpstring("URL to the manufacturer's website")]
    HRESULT ManufacturerURL([out, retval] BSTR * pbstr);

    [propget, id(DISPID_UPNPDEVICE_MODELNAME),
     helpstring("a displayable string containing the model name")]
    HRESULT ModelName([out, retval] BSTR * pbstr);

    [propget, id(DISPID_UPNPDEVICE_MODELNUMBER),
     helpstring("a displayable string containing the model number")]
    HRESULT ModelNumber([out, retval] BSTR * pbstr);

    [propget, id(DISPID_UPNPDEVICE_DESCRIPTION),
     helpstring("displayable summary of the device's function")]
    HRESULT Description([out, retval] BSTR * pbstr);

    [propget, id(DISPID_UPNPDEVICE_MODELURL),
     helpstring("URL to a webpage containing model-specific information")]
    HRESULT ModelURL([out, retval] BSTR * pbstr);

    [propget, id(DISPID_UPNPDEVICE_UPC),
     helpstring("displayable product code")]
    HRESULT UPC([out, retval] BSTR * pbstr);

    [propget, id(DISPID_UPNPDEVICE_SERIALNUMBER),
     helpstring("displayable serial number")]
    HRESULT SerialNumber([out, retval] BSTR * pbstr);

    [id(DISPID_UPNPDEVICE_LOADICON),
     helpstring("retrieves an url from which an icon of the specified format can be loaded")]
    HRESULT IconURL([in] BSTR bstrEncodingFormat,
                    [in] LONG lSizeX,
                    [in] LONG lSizeY,
                    [in] LONG lBitDepth,
                    [out, retval] BSTR * pbstrIconURL);

    [propget, id(DISPID_UPNPDEVICE_SERVICES),
     helpstring("returns the collection of services exposed by the device")]
    HRESULT Services([out, retval] IUPnPServices ** ppusServices);
};


[
    object,
    uuid(E7772804-3287-418e-9072-CF2B47238981),
    pointer_default(unique)
]
interface IUPnPDeviceDocumentAccess : IUnknown
{
    HRESULT GetDocumentURL([out, retval] BSTR * pbstrDocument);
}


[
    object,
    uuid(11d1c1b2-7daa-4c9e-9595-7f82ed206d1e),
    dual,
    helpstring("IUPnPDescriptionDocument Interface"),
    oleautomation,
    pointer_default(unique),
    nonextensible
]
interface IUPnPDescriptionDocument : IDispatch
{
    [propget, id(DISPID_READYSTATE),
     helpstring("the current status of the document's loading process")]
    HRESULT ReadyState([out, retval] LONG * plReadyState);

    [id(DISPID_UPNPDESCRIPTIONDOC_LOAD),
     helpstring("loads a document synchronously from an URL")]
    HRESULT Load([in] BSTR bstrUrl);

    [id(DISPID_UPNPDESCRIPTIONDOC_LOADASYNC),
     helpstring("starts an asynchronous download, returning immediately")]
    HRESULT LoadAsync([in] BSTR bstrUrl, [in] IUnknown * punkCallback);

    [propget, id(DISPID_UPNPDESCRIPTIONDOC_LOADERROR),
     helpstring("the success or failure code of the completed load operation")]
    HRESULT LoadResult([out, retval] long * phrError);

    [id(DISPID_UPNPDESCRIPTIONDOC_ABORT),
     helpstring("stops an asynchronous loading operation")]
    HRESULT Abort();

    [id(DISPID_UPNPDESCRIPTIONDOC_ROOTDEVICE),
     helpstring("returns the root device of the loaded document's device tree")]
    HRESULT RootDevice([out, retval] IUPnPDevice ** ppudRootDevice);

    [id(DISPID_UPNPDESCRIPTIONDOC_DEVICEBYUDN),
     helpstring("returns a device by its unique device name (UDN)")]
    HRESULT DeviceByUDN([in] BSTR bstrUDN,
                        [out, retval] IUPnPDevice ** ppudDevice);
};


[
    object,
    uuid(77394c69-5486-40d6-9bc3-4991983e02da),
    pointer_default(unique)
]
interface IUPnPDescriptionDocumentCallback : IUnknown
{
    HRESULT LoadComplete([in] HRESULT hrLoadResult);
};

[
    uuid(DB3442A7-A2E9-4A59-9CB5-F5C1A5D901E5),
    version(1.0),
    helpstring("UPnP 1.0 Type Library")
]
library UPNPLib
{
    importlib("stdole2.tlb");

	interface IUPnPDeviceFinderCallback;
	interface IUPnPDescriptionDocumentCallback;
	interface IUPnPServiceCallback;
	interface IUPnPServiceCallbackPrivate;
	interface IUPnPDeviceDocumentAccess;

    // UPnPDeviceFinder
	[
        uuid(E2085F28-FEB7-404A-B8E7-E659BDEAAA02),
        helpstring("UPnPDeviceFinder Class")
    ]
    coclass UPnPDeviceFinder
    {
        [default] interface IUPnPDeviceFinder;
    };

    // UPnPDescriptionDocument
	[
        uuid(1d8a9b47-3a28-4ce2-8a4b-bd34e45bceeb),
        helpstring("UPnPDescriptionDocument Class")
    ]
    coclass UPnPDescriptionDocument
    {
        [default] interface IUPnPDescriptionDocument;
    };

};