BluetoothSetLocalServiceInfo 함수(bluetoothapis.h)

  • 아티클

BluetoothSetLocalServiceInfo 함수는 특정 Bluetooth 라디오에 대한 로컬 서비스 정보를 설정합니다.

구문

DWORD BluetoothSetLocalServiceInfo(
  [in, optional] HANDLE                             hRadioIn,
  [in]           const GUID                         *pClassGuid,
  [in]           ULONG                              ulInstance,
  [in]           const BLUETOOTH_LOCAL_SERVICE_INFO *pServiceInfoIn
);

매개 변수

[in, optional] hRadioIn

로컬 서비스 정보를 지정하는 Bluetooth 라디오 디바이스의 핸들입니다. NULL인 경우 BluetoothSetLocalServiceInfo는 사용 가능한 첫 번째 로컬 Bluetooth 라디오를 검색합니다.

[in] pClassGuid

노출할 서비스의 GUID입니다. 서버 쪽 INF 파일의 GUID 와 일치해야 합니다.

[in] ulInstance

플러그 앤 플레이(PnP) ID의 디바이스 노드에 대한 instance ID입니다.

[in] pServiceInfoIn

설정할 로컬 서비스를 설명하는 BLUETOOTH_LOCAL_SERVICE_INFO 구조체에 대한 포인터입니다.

반환 값

BluetoothSetLocalServiceInfo 함수는 다음 값을 반환합니다.

반환 코드 설명
ERROR_NOT_FOUND
 지정한 Bluetooth 라디오가 검색되지 않았습니다.
ERROR_BAD_UNIT
 Bluetooth 라디오가 감지되지 않았습니다.
STATUS_INSUFFICIENT_RESOURCES
 작업을 완료하는 데 충분한 리소스를 사용할 수 없습니다. 100개 이상의 로컬 PDO(물리적 디바이스 개체)가 Bluetooth 서비스에 해당하는 경우 이 오류가 발생할 수 있습니다.
STATUS_PRIVILEGE_NOT_HELD
 호출자에게 필요한 권한이 없습니다. 권한 상승 방법에 대한 자세한 내용은 설명 섹션을 참조하세요.

설명

BluetoothSetLocalServiceInfo는 pClassGuid의 서비스 GUID에서 설명하는 로컬 서비스의 설치를 트리거하기 위해 프로필 드라이버 개발자만 사용하는 사용자 모드 API입니다.

BluetoothSetLocalServiceInfo는 "BTHENUM{ClassGuid}" 형식으로 PnP(플러그 앤 플레이) 디바이스 ID를 생성합니다. 예를 들어 "BTHENUM{xxxxxxxx-xxxx-xxxx-xxxx-xxxx-xxxxxxxxxx}"가 있습니다. 사용자 모드 애플리케이션은 동일한 서비스 GUID를 사용하지만 다른 instance ID를 사용하여 BluetoothSetLocalServiceInfo 후속 시간을 호출하여 지정된 서버 쪽 프로필의 여러 인스턴스를 만들 수 있습니다.

BluetoothSetLocalServiceInfo와 같은 Bluetooth API를 사용하려면 사용자 모드 애플리케이션이 BthProps.lib와 연결되어야 합니다.

경고BluetoothSetLocalServiceInfo 를 호출하는 프로세스에는 SE_LOAD_DRIVER_NAME 권한이 있어야 합니다. 시스템 또는 관리자 컨텍스트에서 실행되는 프로세스는 SDK LookupPrivilegeValue 및 AdjustTokenPrivileges 함수를 사용하여 권한을 상승시킬 수 있습니다. 이에 대한 자세한 내용은 Bluetooth 디바이스 설치를 참조하세요.
 
BLUETOOTH_LOCAL_SERVICE_INFO 구조체는 SDK BluetoothApis.h 헤더 파일에 정의되어 있습니다.

요구 사항

요구 사항 값
지원되는 최소 클라이언트 버전:windows Vista 이상에서 _Supported.
대상 플랫폼 유니버설
헤더 bluetoothapis.h
라이브러리 BthProps.lib
DLL bthprops.cpl; BluetoothAPIs.dll

추가 정보

BLUETOOTH_LOCAL_SERVICE_INFO