Partager via

IOCTL_BTH_SDP_SERVICE_SEARCH IOCTL (bthioctl.h)

  • Article

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

IRP_MJ_DEVICE_CONTROL

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

Voir aussi

BTH_SDP_SERVICE_SEARCH_REQUEST