Important:
This is retired content. This content is outdated and is no longer being maintained. It is provided as a courtesy for individuals who are still using these technologies. This content may contain URLs that were valid when originally published, but now link to sites or pages that no longer exist.
A version of this page is also available for
4/8/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 pRangemember. The serviceHandlemember 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 SdpQueryUuidelement, 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 typeis 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_RESTRICTIONBLOBUUIDs .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 pRangeare ignored.

If typeis equal to SDP_SERVICE_ATTRIBUTE_REQUEST, the serviceHandleis specified. The numRangeparameter indicates the number of attributes to include in the search. The pRangemember is a pointer to these attributes. The UUIDs value is ignored.

If typeis equal to SDP_SERVICE_ATTRIBUTE_REQUEST and the serviceHandleis ignored, all other methods are required.

Requirements

Header bthsdpdef.h
Windows Embedded CE Windows CE .NET 4.0 and later
Windows Mobile Windows Mobile Version 5.0 and later

See Also