IOCTL_BTH_SDP_SERVICE_SEARCH IOCTL (bthioctl.h)
Die IOCTL_BTH_SDP_SERVICE_SEARCH Anforderung kontaktiert ein Remotegerät mit einer SDP-Anforderung für Handles an SDP-Datensätze einer bestimmten Dienstklasse oder -klassen.
Hauptcode
Eingabepuffer
Das AssociatedIrp.SystemBuffer Member enthält einen BTH_SDP_SERVICE_SEARCH_REQUEST Struktur, die das Verbindungshandle mit dem Remote-SDP-Server und ein Array von GUIDs angibt, nach denen gesucht werden soll.
Eingabepufferlänge
Die Länge eines BTH_SDP_SERVICE_SEARCH_REQUEST Struktur/
Ausgabepuffer
Der AssociatedIrp.SystemBuffer Member verweist auf einen Puffer, der ein Array mit variabler Länge mit nicht signierten langen ganzzahligen Werten enthält. Jeder Wert stellt einen SDP-Remotedienstdatensatz dar.
Länge des Ausgabepuffers
Aufrufer können die Länge dieses Arrays bestimmen, indem das Information Member der STATUS_BLOCK Struktur durch sizeof(ULONG)dividiert wird.
Statusblock
Wenn die Anforderung erfolgreich ist, wird das Information Member der STATUS_BLOCK Struktur auf die Größe des Ausgabepuffers in Byte festgelegt. Andernfalls wird der Information Member auf Null festgelegt.
Der Status Members wird auf einen der Werte in der folgenden Tabelle festgelegt.
| Statuswert | Beschreibung |
|---|---|
| STATUS_SUCCESS | Die IOCTL wurde erfolgreich abgeschlossen. |
| STATUS_DEVICE_NOT_CONNECTED | Das Gerät, auf dem sich der SDP-Dienst befindet, war nicht verbunden. |
| STATUS_INSUFFICIENT_RESOURCES | Es war nicht genügend Arbeitsspeicher vorhanden, um diesen Vorgang abzuschließen. |
| STATUS_INVALID_BUFFER_SIZE | Der Ausgabepuffer wurde falsch angepasst. |
| STATUS_INVALID_PARAMETER | Einer der Werte im Eingabepuffer war ungültig. |
| STATUS_REQUEST_NOT_ACCEPTED | Der SDP-Dienst hat die Anforderung abgelehnt. |
| STATUS_TOO_MANY_GUIDS_REQUESTED | Der SDP-Dienst konnte die Anzahl der im Eingabepuffer übergebenen GUIDs nicht verarbeiten. |
Anforderungen
| Anforderung | Wert |
|---|---|
| mindestens unterstützte Client- | Versionen:_Supported in Windows Vista und höher. |
| Header- | bthioctl.h (include Bthioctl.h) |
| IRQL- | <= PASSIVE_LEVEL |