BTH_SET_SERVICE 구조체(ws2bth.h)

  • 아티클

BTH_SET_SERVICE 구조는 지정된 Bluetooth 서비스에 대한 서비스 정보를 제공합니다.

구문

typedef struct _BTH_SET_SERVICE {
  PULONG pSdpVersion;
  HANDLE *pRecordHandle;
  ULONG  fCodService;
  ULONG  Reserved[5];
  ULONG  ulRecordLength;
  UCHAR  pRecord[1];
} BTH_SET_SERVICE, *PBTH_SET_SERVICE, BTHNS_SETBLOB, *PBTHNS_SETBLOB;

멤버

pSdpVersion

SDP 버전입니다. 클라이언트는 이 멤버를 BTH_SDP_VERSION 설정합니다.

pRecordHandle

SDP 레코드에 대한 핸들입니다. SDP ServiceRecordHandle에 해당합니다. 레코드 추가 작업에서 반환된 후 레코드를 삭제하는 데 사용됩니다.

fCodService

COD(디바이스 클래스) 정보입니다. 이 SDP 레코드와 연결된 디바이스 비트의 COD_SERVICE_* 클래스의 32비트 필드입니다. 시스템은 이러한 비트를 다른 서비스 레코드 및 시스템 특성의 COD 비트와 결합합니다. 로컬 라디오에 대한 디바이스의 결과 클래스는 디바이스 조회 중에 라디오가 발견되면 보급됩니다. 특정 서비스 비트와 연결된 마지막 SDP 레코드가 삭제되면 해당 서비스 비트는 이후 디바이스 문의에 대한 응답으로 더 이상 보고되지 않습니다.

COD 필드의 형식 및 가능한 값은 Bluetooth 사양 섹션 1.2의 Bluetooth 할당 번호 1.1 부분에 정의되어 있습니다. (일부 언어 및 국가에서는 이 리소스를 사용할 수 없습니다.) Windows에서 사용하는 COD_SERVICE_* 비트에 대한 해당 매크로 및 정의는 Bthdef.h에 정의되어 있습니다. COD(디바이스 클래스)에 대한 자세한 내용은 BTH_DEVICE_INFO 참조하세요.

Reserved[5]

예약되어 있습니다. 0으로 설정해야 합니다.

ulRecordLength

pRecord의 크기(바이트)입니다.

pRecord[1]

Bluetooth 사양에 정의된 SDP 레코드입니다.

설명

BTH_SET_SERVICE 구조를 사용하여 WSASetService 함수 및 WSAQUERYSET 및 BLOB 구조를 사용하여 서비스 및 디바이스를 쿼리하는 경우 BTH_SET_SERVICE 멤버에 대해 다음 값을 사용해야 합니다.

COD(디바이스 클래스)에 대한 자세한 내용은 www.bluetooth.com Bluetooth 사양을 참조하세요.

멤버 필수 값
pSdpVersion SDP 레코드의 이진 형식이 변경되어 pRecord 멤버의 형식에 영향을 줄 때마다 변경되는 ULONG 버전에 대한 포인터입니다. 클라이언트의 BTH_SDP_VERSION 로 설정하고 시스템에서 반환합니다.
pRecordHandle SDP 레코드에 대한 핸들입니다. 는 SDP ServiceRecordHandle에 해당합니다. 레코드 추가 작업에서 반환된 후 레코드를 삭제하는 데 사용됩니다.
fOptions BTHNS_SET_FLAGS 정의된 특성입니다.
ulRecordLength pRecord가 가리키는 이진 SDP 레코드의 길이(바이트)입니다.
pRecord Bluetooth 사양에 정의된 형식으로 유효한 SDP 레코드에 대한 포인터입니다.
 

pRecordHandle 멤버는 새 서비스 등록을 위해 null인 데이터를 가리킵니다. 서비스 삭제의 경우 pRecordHandle 은 유효한 핸들을 가리킵니다. pRecord 멤버는 Bluetooth 사양에 설명된 대로 전체 SD 서비스 레코드를 포함해야 합니다. RFCOMM 프로토콜 항목의 경우 포트 번호는 getsockname 함수 호출에서 반환된 포트와 동일합니다.

Bluetooth는 SDP 레코드와 서버 소켓 간의 일대일 상관 관계를 구현합니다. 따라서 SERVICE_MULTIPLE 플래그가 필요하지 않습니다.

요구 사항

요구 사항 값
지원되는 최소 클라이언트 Windows Vista, WINDOWS XP SP2 [데스크톱 앱만 해당]
지원되는 최소 서버 지원되는 버전 없음
머리글 ws2bth.h

추가 정보

Bluetooth 및 getsockname

Bluetooth 및 BLOB

Bluetooth 및 WSASetService

WSAQUERYSET