IOCTL_BTH_SDP_SERVICE_SEARCH IOCTL (bthioctl.h)
La demande de IOCTL_BTH_SDP_SERVICE_SEARCH contacte un appareil distant avec une demande SDP pour les handles vers les enregistrements SDP d’une classe de service ou de classes particulières.
Code principal
Mémoire tampon d'entrée
Le membre AssociatedIrp.SystemBuffer contient un BTH_SDP_SERVICE_SEARCH_REQUEST structure qui spécifie le handle de connexion au serveur SDP distant et un tableau d’GUID à rechercher.
Longueur de la mémoire tampon d’entrée
Longueur d’un structure BTH_SDP_SERVICE_SEARCH_REQUEST /
Mémoire tampon de sortie
Le membre AssociatedIrp.SystemBuffer pointe vers une mémoire tampon qui contient un tableau de longueur variable de valeurs d’entiers longs non signés. Chaque valeur représente un enregistrement de service SDP distant.
Longueur de la mémoire tampon de sortie
Les appelants peuvent déterminer la longueur de ce tableau en divisant le membre Information de la structure STATUS_BLOCK par sizeof(ULONG).
Bloc d’état
Si la demande réussit, le membre Information de la structure STATUS_BLOCK est défini sur la taille, en octets, de la mémoire tampon de sortie. Sinon, le membre Information est défini sur zéro.
Le membre Status est défini sur l’une des valeurs du tableau suivant.
| Valeur d’état | Description |
|---|---|
| STATUS_SUCCESS | Le IOCTL s’est terminé avec succès. |
| STATUS_DEVICE_NOT_CONNECTED | L’appareil sur lequel réside le service SDP n’était pas connecté. |
| STATUS_INSUFFICIENT_RESOURCES | La mémoire n’était pas suffisante pour effectuer cette opération. |
| STATUS_INVALID_BUFFER_SIZE | La mémoire tampon de sortie a été correctement dimensionnée. |
| STATUS_INVALID_PARAMETER | L’une des valeurs de la mémoire tampon d’entrée n’était pas valide. |
| STATUS_REQUEST_NOT_ACCEPTED | Le service SDP a rejeté la demande. |
| STATUS_TOO_MANY_GUIDS_REQUESTED | Le service SDP n’a pas pu traiter le nombre de GUID passés dans la mémoire tampon d’entrée. |
Configuration requise
| Condition requise | Valeur |
|---|---|
| Client minimal pris en charge | Versions :_Supported dans Windows Vista et versions ultérieures. |
| En-tête | bthioctl.h (inclure Bthioctl.h) |
| IRQL | <= PASSIVE_LEVEL |