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