共用方式為

行動寬頻 Windows 執行階段 API 概觀

  • 發行項

下表列出撰寫行動寬頻應用程式的 API。

API 描述

線上配置檔 API

例如，提供因特網) 連線狀態的相關信息 (

裝置服務延伸模組 API

啟用裝置特定的擴充功能，例如 SIM 工具組和慣用漫遊清單 (PRL) 下載。

布建 API

可讓您使用帳戶布建數據和數據使用量資訊來布建 Windows。

SIM PIN API

可讓您啟用、停用或變更 SIM 卡 PIN。

SMS API

提供實作SMS用戶端所需的函式。

訂閱者和裝置資訊 API

提供行動寬頻裝置 SIM 卡和裝置資訊的訂閱者資訊。

USSD API

可讓您建立非結構化增補服務數據 (USSD) 工作階段，以及網路 (用戶端和起始的網路) 。

本主題提供下列各節：

行動寬頻帳戶 API

因為它有方法可用來取得客戶的個人標識資訊，並變更行動寬頻裝置上的網路設定，因此行動寬頻帳戶 API 是特殊許可權的 API。 這表示大部分的 UWP app 無法呼叫其方法，而不會收到「拒絕存取」錯誤。 若要能夠呼叫此 API，UWP 應用程式必須符合下列準則：

  • 應用程式必須有與其相關聯的裝置元數據或服務元數據套件，而且它必須列在套件內 SoftwareInfo.xml 檔案的 PrivilegedApplications XML 元素中。 套件不一定是應用程式專屬的;任何特定的 UWP app 都可以列在數個套件的 PrivilegedApplications 元素中。 該套件必須與計算機上至少作用中一次的行動寬頻裝置服務提供者相關聯，才能安裝該套件。

  • 應用程式的 appxmanifest 檔案需要 <行動寬頻帳戶 API 的 DeviceCapability> 專案。 您可以藉由將下列 XML 元素新增為應用程式 appxmanifest 檔案中 Capabilities> 元素的<子系來執行此動作：

    <DeviceCapability Name="BFCD56F7-3943-457F-A312-2E19BB6DC648" />

    如需 Capabilities> 元素的詳細資訊<，請參閱應用程式指令清單檔 for Windows 8。

注意 例如，非 UWP 應用程式的應用程式 (，Microsoft Win32 服務或傳統型應用程式) 對行動寬頻帳戶 API 的存取不受限制。 這是因為這些應用程式可以使用現有的 Win32 和元件物件模型 (COM) API 來取得行動寬頻網路的完整存取權。 這些 API 無法從 UWP 應用程式使用。

網路帳戶標識碼

網路帳戶標識碼是行動寬頻帳戶的唯一標識符。 它提供統一標識碼，不需要知道標識碼是否來自 GSM、CDMA 或 WiMAX 網路。 每當 Windows 遇到之前未遇到的硬體提供網路訂用帳戶標識碼時，Windows 就會產生網路帳戶標識碼。 下列清單會識別每個支援網路類型的網路帳戶識別碼：

  • GSM 網路：SIM 卡的 ICCID 用來區分訂用帳戶。

  • CDMA 網路：使用MIN) 的行動標識碼 (。

當 Windows 第一次遇到上述其中一個網路類型時，它會建立新的網路帳戶標識碼，並將其對應至硬體提供之訂用帳戶標識碼的 SHA-256 哈希，然後將這兩者儲存在登錄中。 相反地，如果 Windows 在登錄中尋找硬體提供之訂用帳戶標識碼的哈希，它會使用與該哈希相關聯的網路帳戶標識碼。 網路帳戶標識碼應該是全域唯一的 (它們是以 GUID) 為基礎，但因為儲存的內容是硬體提供標識符的哈希，所以嘗試將網路帳戶標識碼對應回其產生的 ICCID 或 MIN 時，網路硬體必須存在。

重要 即使從網路帳戶標識碼取得 ICCID 需要存取電腦，以及用來將它們一起對應的網路裝置，網路帳戶標識碼仍可唯一識別個別使用者。 因此，建議您遵循貴組織的原則來處理個人標識資訊。當您使用時，建議您遵循這些原則來處理個人標識資訊。

網路帳戶標識碼會由行動網路操作員隔離 (MNO) ，因此，如果用戶同時有 Provider1 和 Provider2 行動寬頻裝置及其對應的行動寬頻應用程式，則 Provider1 應用程式將無法使用任何 Provider2 網路帳戶標識符，反之亦然。 傳回所有網路帳戶標識碼的函式只會針對應用程式呼叫函式的 MNO 傳回網路帳戶的識別碼。 嘗試使用屬於不同 MNO 的網路帳戶標識碼會導致「拒絕存取」錯誤。

注意 例如，不是UWP應用程式的應用程式 (Win32 服務或傳統型應用程式) 都可以存取所有網路帳戶，而不論網路服務提供者為何。

行動寬頻 WinRT API 概觀