BluetoothSdpGetAttributeValue 関数 (bluetoothapis.h)

[アーティクル]
02/23/2024

BluetoothSdpGetAttributeValue 関数は、属性識別子の属性値を取得します。

構文

DWORD BluetoothSdpGetAttributeValue(
  [in]  LPBYTE            pRecordStream,
  [in]  ULONG             cbRecordLength,
  [in]  USHORT            usAttributeId,
  [out] PSDP_ELEMENT_DATA pAttributeData
);

パラメーター

[in] pRecordStream

1 つの SDP レコードとして書式設定された有効なレコードストリームへのポインター。

[in] cbRecordLength

pRecordStream の長さ (バイト単位)。

[in] usAttributeId

検索する属性識別子。「解説」を参照してください。

[out] pAttributeData

属性の識別子値が配置される SDP_ELEMENT_DATA 構造体へのポインター。

戻り値

正常に完了したときにERROR_SUCCESSを返します。 pAddributeData パラメーターには属性値が含まれています。その他の戻り値は、エラーを示します。次の表では、 BluetoothSdpGetAttributeValue 関数に関連する一般的なエラーコードについて説明します。

リターンコード	説明
ERROR_INVALID_PARAMETER	必要なポインターのいずれかが NULL であるか、 pRecordStream パラメーターが有効な SDP ストリームではなかったか、 pRecordStream パラメーターが正しく書式設定された SDP レコードではなかったかのいずれかです。
ERROR_FILE_NOT_FOUND	usAttributeId で指定された識別子がレコードに見つかりませんでした。

注釈

pRecordStream のレコードストリームは、SDP レコードとして書式設定された SDP ストリーム、属性 ID (UINT16) と属性値 (任意の SDP 要素の種類) のペアを含む SEQUENCE である必要があります。

usAttributeId パラメーターで指定される属性識別子には、bthdef.h ファイルで提供される多くのSDP_ATTRIB_Xxxユニバーサル属性識別子のいずれか、または Bluetooth プロファイルによって定義されたカスタム属性値を指定できます。 0x200以上のすべての値はプロファイル固有の属性識別子であり、プロファイルに固有です。ユニバーサル SDP 属性識別子の一覧については、bthdef.h ヘッダーファイルを参照してください。

要件

要件	値
サポートされている最小のクライアント	Windows Vista、SP2 を使用した Windows XP [デスクトップアプリのみ]
サポートされている最小のサーバー	サポートなし
対象プラットフォーム	Windows
ヘッダー	bluetoothapis.h (Bthsdpdef.h、BluetoothAPIs.h を含む)
Library	Bthprops.lib
[DLL]	bthprops.cpl