BTHNS_RESTRICTIONBLOB
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 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
| Header | bthsdpdef.h |
| Windows Embedded CE | Windows CE .NET 4.0 and later |
| Windows Mobile | Windows Mobile Version 5.0 and later |