ZHCACY9 August 2023 CC2564C
此函數(shù)負(fù)責(zé)查詢本地藍(lán)牙設(shè)備的名稱。此函數(shù)在成功執(zhí)行時(shí)返回零，而在出現(xiàn)任何錯(cuò)誤時(shí)返回負(fù)值。必須存在藍(lán)牙協(xié)議棧 ID，才能嘗試調(diào)用此函數(shù)。
使用此命令時(shí)不需要包含參數(shù)。參數(shù)對(duì)查詢的結(jié)果沒(méi)有影響。
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ù)負(fù)責(zé)查詢（和報(bào)告）本地藍(lán)牙設(shè)備的用戶友好名稱。此函數(shù)的最后幾個(gè)參數(shù)指定要接收本地設(shè)備名稱的緩沖區(qū)和緩沖區(qū)長(zhǎng)度。NameBufferLength 參數(shù)必須至少為 (MAX_NAME_LENGTH+1)，才能容納允許的最長(zhǎng)設(shè)備名稱（加上用于容納 NULL 終止符的單個(gè)字符）。如果此函數(shù)成功，則此函數(shù)返回零，并且 NameBuffer 指向的緩沖區(qū)將填充本地設(shè)備名稱以 NULL 為終止符的 ASCII 表示形式。如果此函數(shù)返回負(fù)值，則無(wú)法查詢本地設(shè)備名稱（錯(cuò)誤情況）。