BluetoothSdpGetString 関数 (bluetoothapis.h)

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

BluetoothSdpGetString 関数は、SDP レコードに埋め込まれた未加工の文字列を Unicode 文字列に変換します。

構文

DWORD BluetoothSdpGetString(
  [in]      LPBYTE                      pRecordStream,
  [in]      ULONG                       cbRecordLength,
  [in]      const PSDP_STRING_TYPE_DATA pStringData,
  [in]      USHORT                      usStringOffset,
  [out]     PWSTR                       pszString,
  [in, out] PULONG                      pcchStringLength
);

パラメーター

[in] pRecordStream

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

[in] cbRecordLength

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

[in] pStringData

NULL に設定すると、呼び出し元のスレッドロケールを使用して、SDP レコード内の一致する文字列が検索されます。 NULL でない場合、変換する文字列を検索するために、SDP_STRING_TYPE_DATA構造体の mibeNum メンバーと attributeId メンバーが使用されます。

[in] usStringOffset

変換する SDP 文字列型オフセット。 usStringOffset は、文字列の基本属性識別子に追加されます。 SDP 仕様で定義されたオフセットは、STRING_NAME_OFFSET、STRING_DESCRIPTION_OFFSET、およびSTRING_PROVIDER_NAME_OFFSETです。これらのオフセットは、bthdef.h ヘッダーファイルにあります。

[out] pszString

NULL でない場合は、出力時に変換された文字列が格納されます。 NULL に設定すると、pcchStringLength パラメーターには、変換された文字列を取得するために必要なバイト数ではなく文字数が入力されます。

[in, out] pcchStringLength

入力時に、pszString が NULL でない場合は、pszString の長さが文字数で格納されます。

出力時に、には、エラーが返された場合は NULL を含む必要な文字の数、または pszString に書き込まれた文字数 ( NULL を含む) が含まれます。

戻り値

正常に完了したときにERROR_SUCCESSを返します。 pszString パラメーターには、変換された文字列が含まれています。エラー時にエラーコードを返します。一般的なエラーを次の表に示します。

リターンコード	説明
ERROR_MORE_DATA	pszString パラメーターが NULL であるか、変換された文字列を格納するには小さすぎます。pcchStringLength パラメーターには、必要な長さが文字数で含まれています。
ERROR_INVALID_DATA	変換を実行できません。
ERROR_NO_SYSTEM_RESOURCES	システムは、変換を実行するために内部的にメモリを割り当てることができません。
ERROR_INVALID_PARAMETER	必要なポインターの 1 つが NULL、 pRecordStream パラメーターが有効な SDP ストリームではなかった、 pRecordStream が正しく書式設定されたレコードではない、または要求された属性とオフセットが文字列ではなかった。

要件

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