SdpCreateNodeString 函数 (sdplib.h)
Bluetooth SdpCreateNodeString 函数用于为字符串类型分配和初始化 SDP_NODE 结构。
语法
PSDP_NODE SdpCreateNodeString(
[in] PCHAR string,
ULONG stringLength,
[in] ULONG tag
);
参数
[in] string
指向用于初始化 SDP_NODE 结构的字符串值的指针。
stringLength
保存字符串长度的无符号长整数值。
[in] tag
要与节点关联的配置文件驱动程序定义的标记。
返回值
如果成功，此函数将返回指向新分配的 SDP_NODE 结构的指针。 如果未成功，此函数将返回 NULL。
注解
在 SdpCreateNodeString 函数分配SDP_NODE结构后，它将通过以下方式初始化结构。
它确保正确设置SDP_NODE结构的数据类型和数据大小字段。
它确保已初始化关联的 SDP_NODE_HEADER 结构的指针成员以指向节点本身。 这将创建一个仅包含一个元素的有效列表。
它确保传递给函数 的值 参数复制到与 SDP_NODE 结构关联的 SDP_NODE_DATA 联合的相应元素。
与 SdpCreateNodeString 函数关联的数据将复制到节点中，并且可以随时释放原始数据。
蓝牙配置文件驱动程序可以通过 BTHDDI_SDP_NODE_INTERFACE获取指向此函数的指针。
要求
| 要求 | 值 |
|---|---|
| 最低受支持的客户端 | 版本：Windows Vista 及更高版本中_Supported。 |
| 目标平台 | 桌面 |
| 标头 | sdplib.h (包括 BthSdpddi.h) |
| IRQL | <= PASSIVE_LEVEL |