从 Microsoft .NET Framework 精简版访问电话 API

Derek Mitchell
DEVBUZZ.COM, Inc.
2003年4月

适用于：
Microsoft® .NET Framework 精简版 1.0
Microsoft Visual Studio® .NET 2003

摘要：学习如何从基于 .NET Framework 精简版的应用程序访问电话 API。

下载 PhoneAPI.msi（英文）

目录

• 简介
• 使用 C# 创建电话呼叫
• 使用 VB.NET 创建电话呼叫
• 使用 C# 访问 SIM 信息
• 使用 VB.NET 访问 SIM 信息
• 代码使用
• 小结

简介

本文旨在通过另外一个示例，说明在用 C# 和 VB.NET 编写的托管代码中调用本机 Microsoft® Win32® API 是大有裨益的。下面，我们看看 Pocket PC Phone Edition 支持的通用电话 API。

使用 C# 创建电话呼叫

本文下面所引用的所有代码都可以从此处下载（英文）。创建呼叫是一个基本操作；我们传递 PhoneMakeCall (Win32 API)，它是一个字符串，指示目标地址以及是否需要在呼叫前确认等操作。我们需要进行多项声明。

private static long PMCF_DEFAULT               = 0x00000001;private static long PMCF_PROMPTBEFORECALLING   = 0x00000002;

然后定义一个对我们的目的用途不太大的结构。

private struct PhoneMakeCallInfo   {      public IntPtr cbSize;      public IntPtr dwFlags;      public IntPtr pszDestAddress;      public IntPtr pszAppName;      public IntPtr pszCalledParty;      public IntPtr pszComment;   }

cbSize 表明 PhoneMakeCallInfo 结构的大小。dwFlags 是一个选项位，用于指定呼叫前是否提示用户。pszDestAddress 是一个指针，指向要拨打的电话号码。当前不支持 pszAppName。pszCalledParty 为可选项，表示被叫方的姓名，大小有限。当前不支持 pszComment。现在，我们激活 PInvoke 并调用 DLLImport，以便访问 API 函数 PhoneMakeCall。

[DllImport("phone.dll")]private static extern IntPtr PhoneMakeCall(ref PhoneMakeCallInfo ppmci);

为了方便起见，我们包含了一个辅助函数，以便省略拨号前确认 Boolean。

/// <summary>/// 拨打指定的电话号码。/// </summary>/// <param name="PhoneNumber">要拨打的电话号码。</param>public static void MakeCall(string PhoneNumber){MakeCall(PhoneNumber, false);}

下面介绍一下 MakeCall 的功能。简而言之，我们将 PhoneNumber 参数（作为字符串传递）分割成一个字符数组。

PhoneNumber += '\0';char[] cPhoneNumber = PhoneNumber.ToCharArray();

指向字符数组在内存中的内存地址，并为此变量加上 fixed 关键字，表示不希望内存回收器移动固定括号内的内容。

   PhoneMakeCallInfo info = new PhoneMakeCallInfo();   info.cbSize = (IntPtr)Marshal.SizeOf(info);   info.pszDestAddress = (IntPtr)pAddr;   if (PromptBeforeCall)   {      info.dwFlags = (IntPtr)PMCF_PROMPTBEFORECALLING;   }   else   {      info.dwFlags = (IntPtr)PMCF_DEFAULT;   }

创建一个新的 PhoneMakeCallInfo 结构实例，指示是否希望在拨号之前进行确认以及是否将电话号码插入 pszDestAddress 字段。最后，我们将该结构实例作为引用传入 PhoneMakeCall。此函数使用 unsafe 关键字进行了修饰，因为它使用指针和直接内存访问。

使用 VB.NET 创建电话呼叫

用 VB.NET 编写的 MakeCall 代码与使用 C# 编写的代码相似（详细代码如上文所示），几乎不需要太大的改动。我们使用 IntPtr 变量保存多数函数的值。两者的不同之处在于，在 MakeCall 的前向声明中，我们指定 PhoneMakeCallInfo 结构实例将作为引用传递。

    <System.Runtime.InteropServices.DllImport("phone.dll")> _    Private Shared Function PhoneMakeCall(ByRef ppmci As       PhoneMakeCallInfo) As IntPtr    End Function

我们基本上按照前面的方法处理 PhoneMakeCallInfo 结构。将 PhoneNumber 字符串分割为一个字符数组，然后将 iPhoneNumber 用作内存调整指针写入内存。

PhoneNumber.Insert(PhoneNumber.Length, " ")Dim cPhoneNumber() As Char = PhoneNumber.ToCharArray()Dim pAddr() As Char = cPhoneNumberDim info As PhoneMakeCallInfo = New PhoneMakeCallInfoinfo.cbSize = System.Runtime.InteropServices.Marshal.SizeOf(info)Dim iPhoneNumber As IntPtr = Marshal.AllocHLocal(cPhoneNumber.Length)        System.Runtime.InteropServices.Marshal.Copy(cPhoneNumber, 0,           iPhoneNumber, cPhoneNumber.Length)info.pszDestAddress = iPhoneNumber

将 pszDestAddress 成员指向此内存空间并设置拨号前确认选项后，将此结构实例传入 PhoneMakeCall。

If PromptBeforeCall Then   info.dwFlags = PMCF_PROMPTBEFORECALLINGElse   info.dwFlags = PMCF_DEFAULTEnd If   res = PhoneMakeCall(info)

使用 C# 访问 SIM 信息

虽然称不上是对 Pocket PC Phone Edition 平台上的可用 SIM 访问函数的详细介绍，但我们将通过介绍如何检索 SIM 所有者的主要电话号码和服务提供程序的名称，进一步说明 P/Invoke 的用途。我们首先定义一个结构，用以存放 ping SIM 卡时获得的值，如下所示。

      [StructLayout(LayoutKind.Sequential)]      private struct SimRecord       {         public IntPtr cbSize;         public IntPtr dwParams;         public IntPtr dwRecordType;         public IntPtr dwItemCount;         public IntPtr dwSize;      }

因为在本机代码和托管代码之间只能自动封送顺序布局结构，所以我们用顺序布局标记修饰我们的结构。cbSize 是所传递结构的大小。dwParams 是参数值，这里我们并不用担心。dwRecordType 表示记录的格式。选项包括：

值 说明

SIM_RECORDTYPE_UNKNOWN	未知的文件类型。
SIM_RECORDTYPE_TRANSPARENT	单个变长记录。
SIM_RECORDTYPE_CYCLIC	循环记录集，每个记录具有相同长度。
SIM_RECORDTYPE_LINEAR	线性记录集，每个记录具有相同长度。
SIM_RECORDTYPE_MASTER	每个 SIM 都有一个主记录，实际上是主节点。
SIM_RECORDTYPE_DEDICATED	实际上是作为其他记录的上级记录的“目录”文件。

dwItemCount 是记录中的项数。dwSize 是记录中每项的大小。接下来，我们将有许多利用了 DLLImport 的函数声明。

      [DllImport("sms.dll")]      private static extern IntPtr SmsGetPhoneNumber(IntPtr psmsaAddress);

检索 SIM 所有者的电话号码。

      [DllImport("cellcore.dll")]      private static extern IntPtr SimInitialize(IntPtr dwFlags, IntPtr         lpfnCallBack, IntPtr dwParam, out IntPtr lphSim);

此函数是调用任何 SIM 访问函数所必需的。如果执行成功，则返回一个指向 HSIM 句柄的指针，以便在随后的调用中使用。

      [DllImport("cellcore.dll")]      private static extern IntPtr SimGetRecordInfo(IntPtr hSim, IntPtr        dwAddress, ref SimRecord lpSimRecordInfo);

此函数接受从 SimInitialize 返回的 HSIM 句柄以及一个 SIM 地址 (dwAddress) 和一个 SIM 记录结构，并用请求的信息填充此结构。

      [DllImport("cellcore.dll")]      private static extern IntPtr SimReadRecord(IntPtr hSim, IntPtr        dwAddress, IntPtr dwRecordType, IntPtr dwIndex, byte[] lpData,        IntPtr dwBufferSize, ref IntPtr lpdwBytesRead);

此函数接受从 SimInitialize 返回的 HSIM 句柄，以及一个 SIM 地址 (dwAddress)、一个 dwRecordType（请参见上表）、dwIndex（如果使用 SIM_RECORDTYPE_CYCLIC 或 SIM_RECORDTYPE_LINEAR）、lpData（指向数据缓冲区）、dwBufferSize（表示缓冲区大小）以及 lpdwBytesRead（表示要读取的字节数）。

      [DllImport("cellcore.dll")]      private static extern IntPtr SimDeinitialize(IntPtr hSim );

此函数发布在 SimInitialize 中创建的 HSIM 句柄的资源。

我们将实现两种重要的电话 API 调用：获取当前 SIM 所有者的电话号码，并获取 SIM 当前访问的服务提供程序的名称。

在 GetPhoneNumber 中，我们所做的只是定义一个大型字节缓冲区并将其传入 SmsGetPhoneNumber。

         Byte[] buffer = new Byte[516];         fixed (byte* pAddr = buffer)         {            IntPtr res = SmsGetPhoneNumber((IntPtr)pAddr);            if (res != IntPtr.Zero)               throw new Exception("无法从 SIM 中获取电话号码");

然后获取返回的 PhoneAddress 类型和 PhoneAddress 电话号码。

         byte *pCurrent = pAddr;         phoneaddr.AddressType =            (AddressType)Marshal.ReadInt32((IntPtr)pCurrent);         pCurrent += Marshal.SizeOf(phoneaddr.AddressType);         phoneaddr.Address = Marshal.PtrToStringUni((IntPtr)pCurrent);      }

此函数声明为 unsafe，因为我们是直接从内存中的托管代码读取。

在下一个函数 GetServiceProvider 中，我们首先初始化 SIM

         res = SimInitialize(IntPtr.Zero, IntPtr.Zero, IntPtr.Zero, out            hSim);         if (res != IntPtr.Zero)            throw new Exception("无法初始化 SIM");

然后声明一个 SIM 记录结构实例，并请求在调用 SimGetRecordInfo 时检索包含 SERVICE_PROVIDER 的值的 SimRecord 的句柄。

         SimRecord rec = new SimRecord();         rec.cbSize = (IntPtr)Marshal.SizeOf(rec);         res = SimGetRecordInfo(hSim, (IntPtr)SERVICE_PROVIDER, ref rec);         if (res != IntPtr.Zero)            throw new Exception("无法从 SIM 中读取服务提供程序的信息");

然后，我们分配一个字节数组，用于存储 SIM 记录（包含 SERVICE_PROVIDER 详细信息）的内容。

         byte[] bData = new byte[(int)rec.dwSize + 1];         IntPtr dwBytesRead = IntPtr.Zero;

然后请求读取 SERVICE_PROVIDER 记录的内容。

      res = SimReadRecord(hSim, (IntPtr)SERVICE_PROVIDER,         rec.dwRecordType, IntPtr.Zero, bData, (IntPtr)bData.Length, ref         dwBytesRead);      if (res != IntPtr.Zero)         throw new Exception("无法从 SIM 中读取服务提供程序");

然后查看返回的结构，并删除在显示最终结果时可能会破坏代码的任何非标准 ASCII 字符。

         byte[] bScrubbed = new byte[(int)dwBytesRead];         int nPos = 0;         // 删除非 ASCII 字符         for (int i = 0; i < (int)dwBytesRead; i ++)         {            if (((int)bData[i] > 19) && ((int)bData[i] < 125))            {               bScrubbed[nPos] = bData[i];               nPos++;            }         }

然后取消初始化 SIM 并释放其资源。

      SimDeinitialize(hSim);

最后，返回“已删除”字节缓冲区的字符串表示形式。

使用 VB.NET 访问 SIM 信息

初始类声明与 C# 中的声明相同：

    Private Shared SERVICE_PROVIDER As Long = &H6F46    <StructLayout(LayoutKind.Sequential)> _    Public Structure SimRecord        Public cbSize As IntPtr        Public dwParams As IntPtr        Public dwRecordType As IntPtr        Public dwItemCount As IntPtr        Public dwSize As IntPtr    End Structure    <System.Runtime.InteropServices.DllImport("sms.dll")> _Private Shared Function SmsGetPhoneNumber(ByVal psmsaAddress As IntPtr) As   IntPtr    End Function    <System.Runtime.InteropServices.DllImport("cellcore.dll")> _Private Shared Function SimInitialize(ByVal dwFlags As IntPtr, ByVal   lpfnCallBack As IntPtr, ByVal dwParam As IntPtr, ByRef lphSim As IntPtr)   As IntPtr    End Function    <System.Runtime.InteropServices.DllImport("cellcore.dll")> _Private Shared Function SimGetRecordInfo(ByVal hSim As IntPtr, ByVal   dwAddress As IntPtr, ByRef lpSimRecordInfo As SimRecord) As IntPtr    End Function    <System.Runtime.InteropServices.DllImport("cellcore.dll")> _Private Shared Function SimReadRecord(ByVal hSim As IntPtr, ByVal   dwAddress As IntPtr, ByVal dwRecordType As IntPtr, _ByVal dwIndex As IntPtr, ByVal lpData() As Byte, ByVal dwBufferSize As   IntPtr, ByRef lpdwBytesRead As IntPtr) As IntPtr    End Function    <System.Runtime.InteropServices.DllImport("cellcore.dll")> _Private Shared Function SimDeinitialize(ByVal hSim As IntPtr) As IntPtr    End Function

GetPhoneNumber 函数相当于 C# 实现。首先创建缓冲区空间，并使用 P/Invoke 调用 SmsGetPhoneNumber 函数。

   Dim phoneaddr As PhoneAddress = New PhoneAddress   Dim buffer(512) As Byte   Dim pAddr() As Byte = buffer   Dim ipAddr As IntPtr = Marshal.AllocHLocal(pAddr.Length)   Dim res As IntPtr = IntPtr.Zero   Try      res = SmsGetPhoneNumber(ipAddr)   Catch ex As Exception      MessageBox.Show(ex.Message)   End Try   If (res.ToInt32 <> 0) Then      Throw New Exception("无法从 SIM 中获取电话号码")   End If

然后从返回的结构中获取地址类型信息。

   phoneaddr.AddressType =      System.Runtime.InteropServices.Marshal.ReadInt32(ipAddr)

将返回的电话号码缓冲区转换为一个字符串，然后返回完整的 PhoneAddress 结构。

GetServiceProvider 函数的情况也与 C# 版本中的情况非常相似。

   Dim hSim, res As IntPtr   hSim = IntPtr.Zero   Dim temp As Long   res = SimInitialize(IntPtr.Zero, Nothing, IntPtr.Zero, hSim)   If (res.ToInt32 <> 0) Then      Throw New Exception("无法初始化 SIM。")   End If

首先初始化 SIM，以便从中检索数据。

   Dim rec As SimRecord = New SimRecord   rec.cbSize =      Marshal.AllocHLocal(System.Runtime.InteropServices       .Marshal.SizeOf(temp))   rec.cbSize = IntPtr.op_Explicit(System.Runtime.InteropServices     .Marshal.SizeOf(rec))

创建一个新的 SimRecord 结构实例且只设置 cbSize 成员（并用 SimRecord 结构的大小填充该成员）。

   res = SimGetRecordInfo(hSim, IntPtr.op_Explicit(SERVICE_PROVIDER), rec)   If (res.ToInt32 <> 0) Then      Throw New Exception("无法从 SMS 中读取服务提供程序的信息。")   End If

调用 SimGetRecordInfo，获取包含 SERVICE_PROVIDER 数据的 SIM 记录的句柄。

   Dim bData((rec.dwSize).ToInt32 + 1) As Byte   Dim dwBytesRead As IntPtr = IntPtr.Zero   res = SimReadRecord(hSim, IntPtr.op_Explicit(SERVICE_PROVIDER),     rec.dwRecordType, IntPtr.Zero, bData,      IntPtr.op_Explicit(bData.Length), dwBytesRead)   If (res.ToInt32 <> 0) Then     Throw New Exception("无法从 SMS 中读取服务提供程序。")End If

然后，正如在 C# 代码中执行的操作一样，必须从产生的字节缓冲区中删除任何非 ASCII 字符，然后转换为字符串并返回该字符串值。

        Dim bScrubbed(dwBytesRead.ToInt32) As Byte        Dim nPos As Int32 = 0        Dim i As Int32        '删除非 ASCII 字符        For i = 0 To dwBytesRead.ToInt32            If bData(i) > 19 And bData(i) < 125 Then                bScrubbed(nPos) = bData(i)                nPos = nPos + 1            End If        Next i        SimDeinitialize(hSim)        Return System.Text.ASCIIEncoding.ASCII.GetString(bScrubbed, 0,          bScrubbed.Length)

代码使用

要使用 C# 从代码中创建电话呼叫，请调用：

Microsoft.Wireless.Phone.MakeCall("电话号码");

要使用 C# 从代码中获取 SIM 用户的电话号码，请调用：

Microsoft.Wireless.Sim.GetPhoneNumber()（该函数返回一个字符串）

要使用 C# 从代码中获取 SIM 用户的服务提供程序，请调用：

Microsoft.Wireless.Sim.GetServiceProvider()（该函数返回一个字符串）

要使用 VB.NET 从代码中创建电话呼叫，请调用：

Phone.MakeCall("电话号码");

要使用 VB.NET 从代码中获取 SIM 用户的电话号码，请调用：

Sim.GetPhoneNumber()（该函数返回一个字符串）

要使用 VB.NET 从代码中获取 SIM 用户的服务提供程序，请调用：

Sim.GetServiceProvider()（该函数返回一个字符串）

小结

本文旨在进一步说明从托管代码中调用重要的 Win32 API 函数类是非常有用且非常容易的。文中简要介绍了电话 API 类的使用。很明显，使用 P/Invoke 可以更好地利用 Win32 API 编程的功能。 <!-- END TOTAL PAGE CONTENT -->