SdpCreateNodeUrl 関数 (sdplib.h)

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

構文

PSDP_NODE SdpCreateNodeUrl(
  [in] PCHAR url,
       ULONG urlLength,
  [in] ULONG tag
);

[in] url

SDP_NODE構造体の初期化に使用される URL 値へのポインター。

urlLength

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

[in] tag

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

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

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

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

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

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

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

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

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