Поделиться через


Функция SdpCreateNodeUrl (sdplib.h)

Функция Bluetooth SdpCreateNodeUrl используется для выделения и инициализации структуры SDP_NODE типа URL-адреса.

Синтаксис

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

Параметры

[in] url

Указатель на значение URL-адреса, используемое для инициализации структуры SDP_NODE.

urlLength

Целое число без знака, которое содержит длину URL-адреса.

[in] tag

Драйвер профиля, определенный тегом для связывания с узлом.

Возвращаемое значение

В случае успешного выполнения эта функция возвращает указатель на только что выделенную SDP_NODE структуру. В противном случае эта функция возвращает NULL.

Замечания

После того как функция sdpCreateNodeUrl выделяет структуруSDP_NODE, она инициализирует структуру следующими способами.

Это гарантирует, что поля данных и размера данных структуры SDP_NODE задаются соответствующим образом.

Это гарантирует, что элементы указателя связанной SDP_NODE_HEADER структуры инициализированы для указания на сам узел. При этом создается допустимый список только с одним элементом.

Он гарантирует, что параметр , передаваемый функции, копируется в соответствующий элемент объединения SDP_NODE_DATA, связанный со структурой SDP_NODE.

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

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

Требования

Требование Ценность
минимальные поддерживаемые клиентские Версии:_Supported в Windows Vista и более поздних версиях.
целевая платформа Настольный
заголовка sdplib.h (include BthSdpddi.h)
IRQL <= PASSIVE_LEVEL

См. также

BTHDDI_SDP_NODE_INTERFACE

SDP_NODE

SDP_NODE_DATA

SDP_NODE_HEADER