c# - 如何从 .NET 应用程序使用 WinFax Pro COM 对象？

Question

我知道，WinFax Pro 是 1998 年的。

(注意:这不是 WinFax.dll，它显然是 Windows 的一部分。这是 WinFax Pro，一个独立的商业附加应用程序，最初来自 Delrina，后来被 Symantec 收购)。

我在仍然使用 WinFax Pro 作为操作系统的办公室工作。他们将客户传真号码存储在 WinFax Pro“电话簿”中，并用它来通知客户上门服务。它现在的工作方式是，某人查看从 Mac 日历生成的(打印的)日程表，然后单击 WinFax 电话簿中所有适当的条目，以发送通知传真。

这就像我们过去所说的“转椅”集成，但指的是 2 个屏幕。这甚至不是 2 个屏幕——它是一张纸和一个屏幕。

无论如何，我正在尝试将其自动化，但遇到了麻烦。

好消息:
- WinFax Pro 将其功能公开为 COM 对象:用于传真发送引擎的 WinFax.SDKSend； WinFax.SDKPhoneBook 通讯录等。
- WinFax Pro 提供了一个类型库 wfxctl32.tlb，它描述了这些不同的 COM 对象。- 我能够通过从 tlbimport 生成的包装器成功使用 .NET (C#) 中的 WinFax.SDKSend 对象。 (我正在使用 .NET 3.5，无法使用 .NET 4.0)。

坏消息:
除了 WinFax.SDKSend 之外，我无法调用 WinFax COM 对象上的任何方法。签名看起来并不比 WinFax.SDKSend 中的签名复杂，但我不断收到异常。

C#代码:

public void Run()
{
    var pb = new wfxctl32.CSDKPhoneBook();
    string id = pb.GetFolderListFirst(1, "");
}

异常:

Exception: System.InvalidCastException: Unable to cast COM object of type 'wfxctl32.CSDKPhoneBookClass' to interface type 'wfxctl32.ISDKPhoneBook'. This operation failed because the QueryInterface call on the COM component for the interface with IID '{A67FCC81-9949-11D0-961E-444553540000}' failed due to the following error: No such interface supported (Exception from HRESULT: 0x80004002 (E_NOINTERFACE)).

at System.RuntimeType.InvokeDispMethod(String name, BindingFlags invokeAttr, Object target, Object[] args, Boolean[] byrefModifiers, Int32 culture, String[] namedParameters)
at System.RuntimeType.InvokeMember(String name, BindingFlags bindingFlags, Binder binder, Object target, Object[] providedArgs, ParameterModifier[] modifiers, CultureInfo culture, String[] namedParams)
at System.RuntimeType.ForwardCallToInvokeMember(String memberName, BindingFlags flags, Object target, Int32[] aWrapperTypes, MessageData& msgData)
at wfxctl32.CSDKPhoneBookClass.GetFolderListFirst(Int16 standardFolder, String folderID)

Answer 1

我打开了the OleView tool ，Windows SDK 的一部分，我可以看到对象上不存在 WinFax.SDKPhoneBook 的 COM 接口(interface)。嗯，这是一个惊喜。接口(interface)由类型库描述，tlbimport.exe 为它生成一个包装器。该接口(interface)也记录在 WinFax Pro SDK PDF 文档中。但是我找不到任何人成功使用 WinFax.SDKPhoneBook 的早期绑定(bind)接口(interface)的示例。

当我尝试使用 javascript 调用 COM 对象时，它工作得很好。

function say(x){ WScript.Echo(x); }

var Folder = function(id) {
    this.Id = id;
    this.DisplayName = null;
    this.Parent = null;
};

Folder.prototype.GetFolderName = function() {
    if (this.DisplayName === null) {
        this.DisplayName = comObject.GetFolderDisplayName(this.Id);
    }
    return (this.Parent === null) ? this.DisplayName
        : this.Parent.GetFolderName() + "/" + this.DisplayName;
};

var comObject = new ActiveXObject("WinFax.SDKPhoneBook");

var GetPbFoldersForId = function(firstId) {
    // stage 1 - do searches for folders
    var list = [];
    var id = firstId;
    do {
        list.push(new Folder(id));
        id = comObject.GetFolderListNext();
    } while (id != "");

    // stage 2 - get subfolders, if any, for each folder
    var subs =[];
    for (var i=0; i<list.length; i++) {
        id = comObject.GetFolderListFirst(0,list[i].Id);
        if (id != "") {
            var a = GetPbFoldersForId(id);  // recurse
            for (var j=0; j < a.length; j++) {
                if (a[j].Parent === null) {a[j].Parent = list[i];}
                subs.push(a[j]);
            }
        }
    }

    for (var k=0; k<subs.length; k++) {
        list.push(subs[k]);
    }

    return list; // a list of folders
};

var id = comObject.GetFolderListFirst(1, "");
Folders = GetPbFoldersForId(id);

for (var k=0; k<Folders.length; k++) {
    say(Folders[k].GetFolderName());
}

这让我得出结论，WinFax Pro COM 接口(interface)不是双重接口(interface) - 它们只是 IDispatch(后期绑定(bind))，并且可以自然地从 VB6、VBScript、Javascript、Perl、Python 和其他后期绑定(bind)语言访问，但不是直接来自 .NET 语言，如 C# 或 VB.NET。

---

Does C# .NET support IDispatch late binding?告诉我如何从 C# 连接 IDispatch 接口(interface)。使用它，我可以做这样的事情:

public sealed class PhoneBook // a singleton
{
    Object comObject;
    Type type;

    private readonly static PhoneBook _instance = new PhoneBook();
    public static PhoneBook Instance  { get { return _instance; } }

    private PhoneBook()
    {
        var t = Type.GetTypeFromProgID("WinFax.SDKPhoneBook");
        if (t == null)
            throw new ArgumentException("WinFax Pro is not installed.");
        comObject = Activator.CreateInstance(t);
        type = comObject.GetType();
    }

    public string GetUserGroupFirst(int flavor, string id)
    {
        var parameters = new Object[2];
        parameters[0] = flavor;
        parameters[1] = id;
        string s = type.InvokeMember("GetUserGroupFirst",
                                     BindingFlags.InvokeMethod,
                                     null,
                                     comObject,
                                     parameters) as String;
        return s;
    }
....

---

PhoneBook 类是 IDispatch 接口(interface)的包装器。我为类型库中的每个方法和属性编写了一个包装器方法。我认为这是 .NET 4.0 会自动为我做的事情。无论如何，这对我来说效果很好。

我在这里发布此问答只是为了让其他与 WinFax Pro 打交道的人可能获得信息。我搜索了整个 intertubes 并找不到任何好的信息，所以我把它放在那里。

---

编辑 - 此 .NET 代码现在在 ASPNET MVC 应用程序中运行，允许用户从网页或 REST 客户端查找条目和发送传真。