c#-4.0 - C# 4、COM 互操作和 UPnP : A trying triumvirate

Question

我正在尝试编写一些使用 UPnP 进行 NAT 遍历的代码(仅供家庭使用)，使用 C# 4 和 Microsoft 基于 COM 的 NAT traversal API (Hnetcfg.dll)。

不幸的是(或许幸运的是)我最后一次必须在 .NET 中进行 COM 互操作是在上个冰河时代的某个时候，我似乎对 C# 使用动态类型进行互操作以及如何编写回调感到非常困惑(以便 COM 服务器调用我的托管代码)。

这是令人兴奋的几行代码:

// Referencing COM NATUPNPLib ("NATUPnP 1.0 Type Library")

using System;
using NATUPNPLib;

class NATUPnPExample
{
    public delegate void NewNumberOfEntriesDelegate(int lNewNumberOfEntries);

    public static void NewNumberOfEntries(int lNewNumberOfEntries)
    {
        Console.WriteLine("New number of entries: {0}", lNewNumberOfEntries);
    }

    public static void Main(string[] args)
    {
        UPnPNAT nat = new UPnPNAT();
        NewNumberOfEntriesDelegate numberOfEntriesCallback = NewNumberOfEntries;

        nat.NATEventManager.NumberOfEntriesCallback = numberOfEntriesCallback;

        nat.StaticPortMappingCollection.Add(4555, "TCP", 4555, "192.168.0.1", true, "UPnPNAT Test");

        // Presumably my NewNumberOfEntries() method should be called by the COM component about now

        nat.StaticPortMappingCollection.Remove(4555, "TCP");
    }
}

在上面的代码中，添加和删除调用工作得非常好。太棒了。

问题是，我还想知道端口映射条目的数量何时发生变化，为此我需要注册一个回调接口(interface)( INATEventManager::put_NumberOfEntriesCallback )，该接口(interface)必须支持 INATNumberOfEntriesCallback 或 IDispatch 接口(interface)。 VS2012的对象浏览器是这样描述INATEventManager::put_NumberOfEntriesCallback的:

dynamic NumberOfEntriesCallback { set; }

是的，所以我的印象是，在 C# 4 中，我不必用花哨的属性来装饰任何东西，并且我可以简单地通过以粗俗的方式将委托(delegate)塞入 INATEventManager::put_NumberOfEntriesCallback 并离开 来注册我的回调。 NET 来担心 IDispatch 并清理困惑；但看来我大错特错了。

那么，呃...我应该怎么做才能确保调用我的 NewNumberOfEntries 方法？

我还有点担心我可以编写 nat.NATEventManager.NumberOfEntriesCallback = 1; 或 nat.NATEventManager.NumberOfEntriesCallback = "Sausages"; 而不会出现异常抛出。

Answer 1

看来我能够让它发挥作用。有两个选项 - 使用自定义接口(interface)“INATNumberOfEntriesCallback”(顺便说一句，它似乎没有在类型库中声明，您需要自己声明)和使用带有 DispId(0) 的普通调度。到 IDispatch/IUnknown 的转换由框架自动执行。所以:

选项 1。

声明 INATNumberOfEntriesCallback 并创建一个实现该接口(interface)的回调类(棘手的部分是 Guid - 它来自“Natupnp.h”文件，并且似乎不在类型库中)。

// declare INATNumberOfEntriesCallback interface 
[ComVisible(true)]
[Guid("C83A0A74-91EE-41B6-B67A-67E0F00BBD78")]
[InterfaceType(ComInterfaceType.InterfaceIsIUnknown)]
public interface INATNumberOfEntriesCallback
{
    void NewNumberOfEntries(int val);
};

// implement callback object
[ComVisible(true)]
[ClassInterface(ClassInterfaceType.None)]
public class CallbackNewNumberOfEntries : INATNumberOfEntriesCallback
{
    public void NewNumberOfEntries(int val)
    {
        Console.WriteLine("Number of entries changed: {0}", val);
    }
}

class NATUPnPExample
{
    public static void Main(string[] args)
    {
        var nat = new UPnPNAT();

        nat.NATEventManager.NumberOfEntriesCallback = new CallbackNewNumberOfEntries();

        nat.StaticPortMappingCollection.Add(4555, "TCP", 4555, "192.168.0.1", true, "UPnPNAT Test");

        // Presumably my NewNumberOfEntries() method should be called by the COM component about now

        nat.StaticPortMappingCollection.Remove(4555, "TCP");
    }
}

选项 2。

使用普通调度。文档说您可以使用 dispid(0) 并且应该使用 4 个(!)参数调用它(请参阅 docs 中的备注部分)。所以基本上以下构造似乎以"dispatch"方式工作:

[ComVisible(true)]
[ClassInterface(ClassInterfaceType.AutoDispatch)]
public class CallbackDisp
{
    [DispId(0)]
    public void OnChange(string updateType, object obj, object name, object val)
    {
        Console.WriteLine("{0}: {1} = {2}", updateType, name, val);
    }
}

class NATUPnPExample
{
    public static void Main(string[] args)
    {
        var nat = new UPnPNAT();

        nat.NATEventManager.NumberOfEntriesCallback = new CallbackDisp();

        nat.StaticPortMappingCollection.Add(4555, "TCP", 4555, "192.168.0.1", true, "UPnPNAT Test");

        // Presumably my NewNumberOfEntries() method should be called by the COM component about now

        nat.StaticPortMappingCollection.Remove(4555, "TCP");
    }
}