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 |