phoneGetData 函式 (tapi.h)
phoneGetData 函式會將資訊從開啟的手機裝置中指定的位置上傳至指定的緩衝區。
語法
LONG phoneGetData(
HPHONE hPhone,
DWORD dwDataID,
LPVOID lpData,
DWORD dwSize
);
參數
hPhone
開啟手機裝置的句柄。
dwDataID
在手機裝置中，要從中上傳緩衝區的位置。
lpData
要上傳數據的記憶體緩衝區指標。
dwSize
數據緩衝區的大小，以位元組為單位。
傳回值
如果要求成功，則傳回零，如果發生錯誤，則傳回負錯誤號碼。 可能的傳回值為：
PHONEERR_INVALPHONEHANDLE、PHONEERR_NOMEM、PHONEERR_INVALPOINTER、PHONEERR_RESOURCEUNAVAIL、PHONEERR_INVALPHONESTATE、PHONEERR_OPERATIONFAILED、PHONEERR_INVALDATAID、PHONEERR_UNINITIALIZED PHONEERR_OPERATIONUNAVAIL。
備註
函式會將來自手機裝置的 dwSize 位元組上限上傳至 lpData 所指向的記憶體區域。 如果 dwSize 為零，則不會複製任何專案。 每個數據區域的大小都會列在手機的裝置功能中。
規格需求
| 需求 | 值 |
|---|---|
| 目標平台 | Windows |
| 標頭 | tapi.h |
| 程式庫 | Tapi32.lib |
| Dll | Tapi32.dll |