BTHNS_RESTRICTIONBLOB (Compact 2013)

  • Article

3/26/2014

This structure contains details about a query restriction.

Syntax

typedef struct _BTHNS_RESTRICTIONBLOB {
  ULONG type;
  ULONG serviceHandle;
  SdpQueryUuid uuids[MAX_UUIDS_IN_QUERY];
  ULONG numRange;
  SdpAttributeRange pRange[1];
} BTHNS_RESTRICTIONBLOB, *PBTHNS_RESTRICTIONBLOB;

Members

  • type
    Type of search to perform. This value can be SDP_SERVICE_SEARCH_REQUEST, SDP_SERVICE_SEARCH_ATTRIBUTE_REQUEST, or SDP_SERVICE_ATTRIBUTE_REQUEST.
  • serviceHandle
    Service handle on which to query the attributes in the pRange member. The serviceHandle member is used for attribute searches.
  • uuids
    Used for service and service attribute searches. Specifies the UUIDs that a record must contain to match the search. If less than 12 UUIDs are to be queried, set the SdpQueryUuid element, immediately following the last valid UUID, to all zeros.
  • numRange
    Used for attribute and service attribute searches. Specifies the number of elements in pRange.
  • pRange
    Used for attribute and service attribute searches. Specifies the attribute values to retrieve for any matching records.

Remarks

This structure can be pointed to by the lpblob member of a WSAQUERYSET (Bluetooth) structure. See WSALookupServiceBegin (Bluetooth) or BthNsLookupServiceBegin.

If type is equal to SDP_SERVICE_SEARCH_REQUEST, a service search request is performed. This search specifies service UUIDs. The server returns the appropriate service handles. In this scenario, the only other parameter that needs to be specified is the BTHNS_RESTRICTIONBLOB UUIDs*.* This structure contains up to 12 UUIDs. If less than 12 UUIDs are included, the array should be set to 0 after the last valid UUID element is specified. Values specified for numRange and pRange are ignored.

If type is equal to SDP_SERVICE_ATTRIBUTE_REQUEST, the serviceHandle is specified. The numRange parameter indicates the number of attributes to include in the search. The pRange member is a pointer to these attributes. The UUIDs value is ignored.

If type is equal to SDP_SERVICE_ATTRIBUTE_REQUEST and the serviceHandle is ignored, all other methods are required.

Requirements

Header

bthapi.h

See Also

Reference

Bluetooth Application Development Structures
SdpQueryUuid
SdpAttributeRange