BluetoothSdpGetString 関数 (bluetoothapis.h)
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 パラメーターには、変換された文字列が含まれています。 エラー時にエラー コードを返します。 一般的なエラーを次の表に示します。
| リターン コード | 説明 |
|---|---|
|
pszString パラメーターが NULL であるか、変換された文字列を格納するには小さすぎます。pcchStringLength パラメーターには、必要な長さが文字数で含まれています。 |
|
変換を実行できません。 |
|
システムは、変換を実行するために内部的にメモリを割り当てることができません。 |
|
必要なポインターの 1 つが NULL、 pRecordStream パラメーターが有効な SDP ストリームではなかった、 pRecordStream が正しく書式設定されたレコードではない、または要求された属性とオフセットが文字列ではなかった。 |
要件
| 要件 | 値 |
|---|---|
| サポートされている最小のクライアント | Windows Vista、SP2 を使用した Windows XP [デスクトップ アプリのみ] |
| サポートされている最小のサーバー | サポートなし |
| 対象プラットフォーム | Windows |
| ヘッダー | bluetoothapis.h (Bthsdpdef.h、BluetoothAPIs.h を含む) |
| Library | Bthprops.lib |
| [DLL] | bthprops.cpl |