IOCTL_BTH_SDP_SERVICE_SEARCH IOCTL (btlctl.h)
IOCTL_BTH_SDP_SERVICE_SEARCH要求與 SDP 要求連絡遠端裝置,以處理特定服務類別或類別的 SDP 記錄。
主要程序代碼
輸入緩衝區
AssociatedIrp.SystemBuffer 成員包含 BTH_SDP_SERVICE_SEARCH_REQUEST 結構,指定要搜尋之遠端 SDP 伺服器的連線句柄和 GUID 陣列。
輸入緩衝區長度
的長度 BTH_SDP_SERVICE_SEARCH_REQUEST 結構/
輸出緩衝區
AssociatedIrp.SystemBuffer 成員指向緩衝區,其中包含不帶正負號長整數值的可變長度陣列。 每個值都代表遠端 SDP 服務記錄。
輸出緩衝區長度
呼叫端可以藉由將 STATUS_BLOCK 結構sizeof(ULONG)
的信息成員除以 判斷此陣列的長度。
狀態區塊
如果要求成功,則STATUS_BLOCK結構 的資訊成員會 設定為輸出緩衝區的大小,以位元組為單位。 否則, 信息 成員會設定為零。
Status 成員會設定為下表中的其中一個值。
狀態值 | 描述 |
---|---|
STATUS_SUCCESS | IOCTL 成功完成。 |
STATUS_DEVICE_NOT_CONNECTED | SDP 服務所在的裝置未連線。 |
STATUS_INSUFFICIENT_RESOURCES | 記憶體不足,無法完成這項作業。 |
STATUS_INVALID_BUFFER_SIZE | 輸出緩衝區的大小不正確。 |
STATUS_INVALID_PARAMETER | 輸入緩衝區中的其中一個值無效。 |
STATUS_REQUEST_NOT_ACCEPTED | SDP 服務拒絕要求。 |
STATUS_TOO_MANY_GUIDS_REQUESTED | SDP 服務無法處理輸入緩衝區中傳遞的 GUID 數目。 |
規格需求
需求 | 值 |
---|---|
最低支援的用戶端 | Windows Vista 和更新版本中的版本:_Supported。 |
標頭 | btlctl.h (包括 Btlctl.h) |
IRQL | <= PASSIVE_LEVEL |