SdpCreateNodeString 関数 (sdplib.h)

Bluetooth SdpCreateNodeString 関数は、 SDP_NODE 構造体を文字列型に割り当てて初期化するために使用されます。

構文

PSDP_NODE SdpCreateNodeString(
  [in] PCHAR string,
       ULONG stringLength,
  [in] ULONG tag
);

[in] string

SDP_NODE構造体を初期化する文字列値へのポインター。

stringLength

文字列の長さを保持する符号なし long 整数値。

[in] tag

ノードに関連付けるプロファイルドライバー定義タグ。

成功した場合、この関数は新しく割り当てられたSDP_NODE構造体へのポインターを返します。成功しなかった場合、この関数は NULL を返します。

SdpCreateNodeString 関数は、SDP_NODE構造体を割り当てた後、次の方法で構造体を初期化します。

これにより、SDP_NODE構造体のデータ型フィールドとデータサイズフィールドが適切に設定されます。

これにより、関連付けられている SDP_NODE_HEADER 構造体のポインターメンバーが、ノード自体を指すために初期化されます。これにより、要素が 1 つだけの有効なリストが作成されます。

これにより、関数に渡される値パラメーターが、SDP_NODE構造体に関連付けられている SDP_NODE_DATA 共用体の適切な要素に確実にコピーされます。

SdpCreateNodeString 関数に関連付けられているデータはノードにコピーされ、元のデータはいつでも解放できます。

Bluetooth プロファイルドライバーは、 BTHDDI_SDP_NODE_INTERFACEを介してこの関数へのポインターを取得できます。

要件	値
サポートされている最小のクライアント	バージョン:Windows Vista 以降の_Supported。
対象プラットフォーム	デスクトップ
Header	sdplib.h (BthSdpddi.h を含む)
IRQL	<= PASSIVE_LEVEL