Share via

Функция 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_DATA , связанный со структурой SDP_NODE.

Данные, связанные с функцией SdpCreateNodeString , копируются в узел, и исходные данные могут быть освобождены в любое время.

Драйверы профилей Bluetooth могут получить указатель на эту функцию через BTHDDI_SDP_NODE_INTERFACE.

Требования

Требование Значение
Минимальная версия клиента Versions:_Supported в Windows Vista и более поздних версий.
Целевая платформа Персональный компьютер
Верхняя часть sdplib.h (включая BthSdpddi.h)
IRQL <= PASSIVE_LEVEL

См. также раздел

BTHDDI_SDP_NODE_INTERFACE

SDP_NODE

SDP_NODE_DATA

SDP_NODE_HEADER