ZHCACZ5 August 2023 CC2564C
GetLocalName 命令負責(zé)查詢本地藍牙設(shè)備的名稱。此命令在成功執(zhí)行時返回零，而在出現(xiàn)任何錯誤時返回負值。必須存在藍牙協(xié)議棧 ID，才能嘗試調(diào)用此命令。
使用此命令時不需要包含參數(shù)。參數(shù)對查詢的結(jié)果沒有影響。
GAP_Query_Local_Device_Name(BluetoothStackID, 257, (char *)LocalName)
int BTPSAPI GAP_Query_Local_Device_Name(unsigned int BluetoothStackID, unsigned int NameBufferLength, char *NameBuffer)
此函數(shù)負責(zé)查詢（和報告）本地藍牙設(shè)備的用戶友好名稱。該函數(shù)的最后幾個參數(shù)指定要接收本地設(shè)備名稱的緩沖區(qū)和緩沖區(qū)長度。NameBufferLength 參數(shù)至少為 MAX_NAME_LENGTH+1，以保存允許的最長設(shè)備名稱加上用于保留 NULL 終止符的單個字符。如果此函數(shù)成功，則此函數(shù)返回零，并且 NameBuffer 指向的緩沖區(qū)將填充本地設(shè)備名稱以 NULL 為終止符的 ASCII 表示形式。如果此函數(shù)返回負值，則無法查詢本地設(shè)備名稱（錯誤情況）。