BTHNS_RESTRICTIONBLOB (Windows Embedded CE 6.0)

1/6/2010

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

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 numRangeand 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

See Also

Reference

Bluetooth Application Development Structures
SdpQueryUuid