IOCTL_BTH_SDP_SERVICE_SEARCH IOCTL (bthioctl.h)
La demande IOCTL_BTH_SDP_SERVICE_SEARCH contacte un appareil distant avec une demande SDP pour les handles aux 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 de 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
L'AssociatedIrp.SystemBuffer membre pointe vers une mémoire tampon qui contient un tableau de longueur variable de valeurs entières longues non signées. 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 requête réussit, l'Informations membre de la structure STATUS_BLOCK est défini sur la taille, en octets, de la mémoire tampon de sortie. Dans le cas contraire, 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’a pas été connecté. |
| STATUS_INSUFFICIENT_RESOURCES | Il n’y avait pas assez de mémoire pour terminer 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. |
Exigences
| Exigence | Valeur |
|---|---|
| client minimum pris en charge | Versions :_Supported dans Windows Vista et versions ultérieures. |
| d’en-tête | bthioctl.h (include Bthioctl.h) |
| IRQL | <= PASSIVE_LEVEL |