說明

此函數負責查詢本地藍牙設備的名稱。此函數在成功執行時返回零，而在出現任何錯誤時返回負值。必須存在藍牙協議棧 ID，才能嘗試調用此函數。

參數

使用此命令時不需要包含參數。參數對查詢的結果沒有影響。

可能的返回值

• (0) 成功查詢本地設備名稱
• (-8) INVALID_STACK_ID_ERROR
• (-4) FUNCTION_ERROR
• (-2) BTPS_ERROR_INVALID_BLUETOOTH_STACK_ID
• (-1) BTPS_ERROR_INVALID_PARAMETER
• (-57) BTPS_ERROR_DEVICE_HCI_ERROR
• (-65) BTPS_ERROR_INSUFFICIENT_BUFFER_SPACE

API 調用

GAP_Query_Local_Device_Name(BluetoothStackID, 257, (char *)LocalName)

API 原型

int BTPSAPI GAP_Query_Local_Device_Name(unsigned int BluetoothStackID, unsigned int NameBufferLength, char *NameBuffer)

API 說明

此函數負責查詢（和報告）本地藍牙設備的用戶友好名稱。此函數的最后幾個參數指定要接收本地設備名稱的緩沖區和緩沖區長度。NameBufferLength 參數必須至少為 (MAX_NAME_LENGTH+1)，才能容納允許的最長設備名稱（加上用于容納 NULL 終止符的單個字符）。如果此函數成功，則此函數返回零，并且 NameBuffer 指向的緩沖區將填充本地設備名稱以 NULL 為終止符的 ASCII 表示形式。如果此函數返回負值，則無法查詢本地設備名稱（錯誤情況）。