nl::Weave::WeaveMessageLayer

#include <src/lib/core/WeaveMessageLayer.h>

คำจำกัดความของคลาส WeaveMessageLayer ซึ่งจัดการการสื่อสารกับโหนด Weave อื่นๆ

สรุป

โดยใช้ปลายทาง InetLayer อย่างใดอย่างหนึ่งเพื่อสร้างช่องทางการสื่อสารกับโหนด Weave อื่นๆ

ผู้ผลิตและผู้ทำลาย
WeaveMessageLayer(void)
ตัวสร้างเลเยอร์ Weave Message

ประเภทสาธารณะ
AcceptErrorFunct)(WeaveMessageLayer *msgLayer, WEAVE_ERROR err) typedef
void(*
ฟังก์ชันนี้เป็นการติดต่อกลับชั้นที่สูงกว่าสำหรับการรายงานข้อผิดพลาดระหว่างการจัดการการเชื่อมต่อ TCP ขาเข้า
CallbackRemovedFunct)(void *listenerState) typedef
void(*
มีการเรียกใช้ฟังก์ชันนี้เพื่อนำโค้ดเรียกกลับออก
ConnectionReceiveFunct)(WeaveMessageLayer *msgLayer, WeaveConnection *con) typedef
void(*
ฟังก์ชันนี้เป็นโค้ดเรียกกลับชั้นที่สูงกว่าในการจัดการการเชื่อมต่อ TCP ขาเข้า
MessageLayerActivityChangeHandlerFunct)(bool messageLayerIsActive) typedef
void(*
ฟังก์ชันนี้คือโค้ดเรียกกลับของแอปพลิเคชันสำหรับการรายงานการเปลี่ยนแปลงกิจกรรมเลเยอร์ข้อความ
MessageReceiveFunct)(WeaveMessageLayer *msgLayer, WeaveMessageInfo *msgInfo, PacketBuffer *payload) typedef
void(*
ฟังก์ชันนี้เป็นโค้ดเรียกกลับชั้นที่สูงกว่าซึ่งจะเกิดขึ้นเมื่อได้รับข้อความ Weave ผ่าน UDP
ReceiveErrorFunct)(WeaveMessageLayer *msgLayer, WEAVE_ERROR err, const IPPacketInfo *pktInfo) typedef
void(*
ฟังก์ชันนี้เป็นการเรียกกลับชั้นที่สูงกว่าเมื่อพบข้อผิดพลาด
State{
  kState_NotInitialized = 0,
  kState_Initializing = 1,
  kState_Initialized = 2
} 		enum
สถานะของ WeaveMessageLayer
TunneledMsgReceiveFunct)(WeaveMessageLayer *msgLayer, PacketBuffer *payload) typedef
void(*
ฟังก์ชันนี้เป็นโค้ดเรียกกลับเลเยอร์ที่สูงกว่าที่ได้เรียกใช้เมื่อได้รับแพ็กเก็ต Tunneled ผ่านอุโมงค์ UDP ภายใน

แอตทริบิวต์สาธารณะ
AppState
void *
ตัวชี้ไปยังออบเจ็กต์สถานะเฉพาะแอปพลิเคชัน
ExchangeMgr
[อ่านอย่างเดียว] ออบเจ็กต์ WeaveExchangeManager ที่เกี่ยวข้อง
FabricState
[อ่านอย่างเดียว] ออบเจ็กต์ WeaveFabricState ที่เกี่ยวข้อง
IncomingConIdleTimeout
uint32_t
ระยะหมดเวลาเนื่องจากไม่มีการใช้งานเริ่มต้น (เป็นมิลลิวินาที) สำหรับการเชื่อมต่อขาเข้า
Inet
InetLayer *
[อ่านอย่างเดียว] ออบเจ็กต์ InetLayer ที่เกี่ยวข้อง
IsListening
bool
[อ่านอย่างเดียว] เป็นจริงหากกําลังฟังการเชื่อมต่อ/ข้อความที่เข้ามาใหม่ หากไม่เป็นเช่นนั้นจะเป็นเท็จ
OnAcceptError
OnConnectionReceived
OnMessageReceived
OnReceiveError
OnUDPTunneledMessageReceived
SecurityMgr
[อ่านอย่างเดียว] ออบเจ็กต์ WeaveSecurityManager ที่เกี่ยวข้อง
State
uint8_t
[อ่านอย่างเดียว] สถานะของออบเจ็กต์ WeaveMessageLayer
SystemLayer
mDropMessage
bool
ภายในและสำหรับการแก้ไขข้อบกพร่องเท่านั้น เมื่อตั้งค่า WeaveMessageLayer จะลบข้อความและส่งคืน

ฟังก์ชันสาธารณะ
ClearUnsecuredConnectionListener(ConnectionReceiveFunct oldOnUnsecuredConnectionReceived, CallbackRemovedFunct newOnUnsecuredConnectionCallbacksRemoved)
CloseEndpoints(void)
ปิดปลายทาง TCP และ UDP ที่เปิดอยู่ทั้งหมด
CreateTunnel(WeaveConnectionTunnel **tunPtr, WeaveConnection & conOne, WeaveConnection & conTwo, uint32_t inactivityTimeoutMS)
สร้าง WeaveConnectionTunnel โดยเชื่อมต่อ WeaveConnections ที่ระบุ 2 รายการเข้าด้วยกัน
DecodeHeader(PacketBuffer *msgBuf, WeaveMessageInfo *msgInfo, uint8_t **payloadStart)
ถอดรหัสส่วนหัวของเลเยอร์ Weave Message จากข้อความ Weave ที่ได้รับ
EncodeMessage(WeaveMessageInfo *msgInfo, PacketBuffer *msgBuf, WeaveConnection *con, uint16_t maxLen, uint16_t reserve)
เข้ารหัสส่วนหัว WeaveMessageLayer ลงใน PacketBuffer
EncodeMessage(const IPAddress & destAddr, uint16_t destPort, InterfaceId sendIntId, WeaveMessageInfo *msgInfo, PacketBuffer *payload)
เข้ารหัสส่วนหัวของเลเยอร์ Weave Message ลงใน PacketBuffer
EphemeralUDPPortEnabled(void) const
bool
ตรวจสอบว่าควรส่งการแลกเปลี่ยน Weave UDP ที่เริ่มต้นในเครื่องจากพอร์ตแหล่งที่มา UDP ชั่วคราวหรือไม่
GetConnectionPoolStats(nl::Weave::System::Stats::count_t & aOutInUse) const
void
รับจำนวน WeaveConnections ที่ใช้งานอยู่และขนาดของพูล
IPv4ListenEnabled(void) const
bool
ตรวจสอบว่ามีการกำหนดค่า WeaveMessageLayer ให้รับการสื่อสารขาเข้าผ่าน IPv4 หรือไม่
IPv6ListenEnabled(void) const
bool
ตรวจสอบว่ามีการกำหนดค่า WeaveMessageLayer ให้รับการสื่อสารขาเข้าผ่าน IPv4 หรือไม่
Init(InitContext *context)
เริ่มต้นออบเจ็กต์เลเยอร์ข้อความ Weave
IsBoundToLocalIPv4Address(void) const
bool
ตรวจสอบว่า WeaveMessageLayer เชื่อมโยงกับที่อยู่ IPv4 ในเครื่องหรือไม่
IsBoundToLocalIPv6Address(void) const
bool
ตรวจสอบว่า WeaveMessageLayer เชื่อมโยงกับที่อยู่ IPv6 ในเครื่องหรือไม่
IsMessageLayerActive(void)
bool
NewConnection(void)
สร้างออบเจ็กต์ WeaveConnection ใหม่จากพูล
NewConnectionTunnel(void)
สร้างออบเจ็กต์ WeaveConnectionTunnel ใหม่จากพูล
ReEncodeMessage(PacketBuffer *buf)
RefreshEndpoints(void)
รีเฟรชปลายทาง InetLayer ตามสถานะปัจจุบันของอินเทอร์เฟซเครือข่ายของระบบ
ResendMessage(WeaveMessageInfo *msgInfo, PacketBuffer *msgBuf)
ส่งข้อความ Weave ที่เข้ารหัสอีกครั้งโดยใช้ปลายทาง Inetlayer UDP ที่เกี่ยวข้อง
ResendMessage(const IPAddress & destAddr, WeaveMessageInfo *msgInfo, PacketBuffer *msgBuf)
ส่งข้อความ Weave ที่เข้ารหัสอีกครั้งโดยใช้ปลายทาง Inetlayer UDP ที่เกี่ยวข้อง
ResendMessage(const IPAddress & destAddr, uint16_t destPort, WeaveMessageInfo *msgInfo, PacketBuffer *msgBuf)
ส่งข้อความ Weave ที่เข้ารหัสอีกครั้งโดยใช้ปลายทาง Inetlayer UDP ที่เกี่ยวข้อง
ResendMessage(const IPAddress & destAddr, uint16_t destPort, InterfaceId interfaceId, WeaveMessageInfo *msgInfo, PacketBuffer *msgBuf)
ส่งข้อความ Weave ที่เข้ารหัสอีกครั้งโดยใช้ปลายทาง Inetlayer UDP ที่เกี่ยวข้อง
SendMessage(WeaveMessageInfo *msgInfo, PacketBuffer *msgBuf)
ส่งข้อความ Weave โดยใช้ปลายทาง Inetlayer UDP พื้นฐานหลังจากเข้ารหัส
SendMessage(const IPAddress & destAddr, WeaveMessageInfo *msgInfo, PacketBuffer *msgBuf)
ส่งข้อความ Weave โดยใช้ปลายทาง Inetlayer UDP พื้นฐานหลังจากเข้ารหัส
SendMessage(const IPAddress & destAddr, uint16_t destPort, InterfaceId sendIntfId, WeaveMessageInfo *msgInfo, PacketBuffer *msgBuf)
ส่งข้อความ Weave โดยใช้ปลายทาง Inetlayer UDP พื้นฐานหลังจากเข้ารหัส
SendUDPTunneledMessage(const IPAddress & destAddr, WeaveMessageInfo *msgInfo, PacketBuffer *msgBuf)
ฟังก์ชันเพื่อส่งแพ็กเก็ต Tunneled ผ่านอุโมงค์ UDP ภายใน
SetSignalMessageLayerActivityChanged(MessageLayerActivityChangeHandlerFunct messageLayerActivityChangeHandler)
void
ตั้งค่าเครื่องจัดการแอปพลิเคชันที่จะถูกเรียกทุกครั้งที่กิจกรรมของชั้นข้อความเปลี่ยนแปลง
SetTCPListenEnabled(bool val)
void
เปิดหรือปิดใช้การฟังสำหรับการเชื่อมต่อ TCP ขาเข้าใน WeaveMessageLayer
SetUDPListenEnabled(bool val)
void
เปิดหรือปิดใช้การฟังข้อความ UDP ขาเข้าใน WeaveMessageLayer
SetUnsecuredConnectionListener(ConnectionReceiveFunct newOnUnsecuredConnectionReceived, CallbackRemovedFunct newOnUnsecuredConnectionCallbacksRemoved, bool force, void *listenerState)
Shutdown(void)
TCPListenEnabled(void) const
bool
ตรวจสอบว่ามีการกำหนดค่า WeaveMessageLayer ให้รับการเชื่อมต่อ TCP ขาเข้าหรือไม่
UDPListenEnabled(void) const
bool
ตรวจสอบว่ามีการกำหนดค่า WeaveMessageLayer ให้รอรับข้อความ UDP ขาเข้าหรือไม่
UnsecuredListenEnabled(void) const
bool
เปิดหรือปิดการเริ่มการแลกเปลี่ยน Weave UDP จากพอร์ตแหล่งที่มา UDP ชั่วคราว

ฟังก์ชันแบบคงที่แบบสาธารณะ
GetMaxWeavePayloadSize(const PacketBuffer *msgBuf, bool isUDP, uint32_t udpMTU)
uint32_t
รับขนาดเพย์โหลด Weave สูงสุดสำหรับการกำหนดค่าข้อความและ PacketBuffer ที่ระบุ
GetPeerDescription(char *buf, size_t bufSize, uint64_t nodeId, const IPAddress *addr, uint16_t port, InterfaceId interfaceId, const WeaveConnection *con)
void
สร้างสตริงที่อธิบายโหนดเพียร์และข้อมูลที่อยู่ / การเชื่อมต่อที่เกี่ยวข้อง
GetPeerDescription(char *buf, size_t bufSize, const WeaveMessageInfo *msgInfo)
void
สร้างสตริงที่อธิบายโหนดเพียร์ตามข้อมูลที่เชื่อมโยงกับข้อความที่ได้รับจากการเพียร์

คลาส
nl::Weave::WeaveMessageLayer::InitContext

คำจำกัดความของคลาส InitContext

ประเภทสาธารณะ

AcceptErrorFunct

void(* AcceptErrorFunct)(WeaveMessageLayer *msgLayer, WEAVE_ERROR err)

ฟังก์ชันนี้เป็นการติดต่อกลับชั้นที่สูงกว่าสำหรับการรายงานข้อผิดพลาดระหว่างการจัดการการเชื่อมต่อ TCP ขาเข้า

รายละเอียด
พารามิเตอร์
[in] msgLayer
ตัวชี้ไปยังออบเจ็กต์ WeaveMessageLayer
[in] err
WEAVE_ERROR ที่พบเมื่อจัดการการเชื่อมต่อ TCP ขาเข้า

CallbackRemovedFunct

void(* CallbackRemovedFunct)(void *listenerState)

มีการเรียกใช้ฟังก์ชันนี้เพื่อนำโค้ดเรียกกลับออก

รายละเอียด
พารามิเตอร์
[in] listenerState
ตัวชี้ไปยังออบเจ็กต์สถานะของแอปพลิเคชัน

ConnectionReceiveFunct

void(* ConnectionReceiveFunct)(WeaveMessageLayer *msgLayer, WeaveConnection *con)

ฟังก์ชันนี้เป็นโค้ดเรียกกลับชั้นที่สูงกว่าในการจัดการการเชื่อมต่อ TCP ขาเข้า

รายละเอียด
พารามิเตอร์
[in] msgLayer
ตัวชี้ไปยังออบเจ็กต์ WeaveMessageLayer
[in] con
ตัวชี้ไปยังออบเจ็กต์ WeaveConnection

MessageLayerActivityChangeHandlerFunct

void(* MessageLayerActivityChangeHandlerFunct)(bool messageLayerIsActive)

ฟังก์ชันนี้คือโค้ดเรียกกลับของแอปพลิเคชันสำหรับการรายงานการเปลี่ยนแปลงกิจกรรมเลเยอร์ข้อความ

ชั้นข้อความจะถือว่ามีการใช้งานหากมีคำขอซิงค์ข้อมูลสำหรับตัวนับข้อความแบบเปิดหรือแบบรอดำเนินการอยู่อย่างน้อย 1 รายการ

รายละเอียด
พารามิเตอร์
[in] messageLayerIsActive
ค่าบูลีนที่ระบุว่าเลเยอร์ข้อความมีการใช้งานอยู่หรือไม่

MessageReceiveFunct

void(* MessageReceiveFunct)(WeaveMessageLayer *msgLayer, WeaveMessageInfo *msgInfo, PacketBuffer *payload)

ฟังก์ชันนี้เป็นโค้ดเรียกกลับชั้นที่สูงกว่าซึ่งจะเกิดขึ้นเมื่อได้รับข้อความ Weave ผ่าน UDP

รายละเอียด
พารามิเตอร์
[in] msgLayer
ตัวชี้ไปยังออบเจ็กต์ WeaveMessageLayer
[in] msgInfo
ตัวชี้ไปยังออบเจ็กต์ WeaveMessageInfo
[in] payload
ชี้ไปที่ข้อความ PacketBuffer ที่มีแพ็กเก็ต Tunnel ที่ได้รับแล้ว

ReceiveErrorFunct

void(* ReceiveErrorFunct)(WeaveMessageLayer *msgLayer, WEAVE_ERROR err, const IPPacketInfo *pktInfo)

ฟังก์ชันนี้เป็นการเรียกกลับชั้นที่สูงกว่าเมื่อพบข้อผิดพลาด

รายละเอียด
พารามิเตอร์
[in] msgLayer
ตัวชี้ไปยังออบเจ็กต์ WeaveMessageLayer
[in] err
WEAVE_ERROR ที่พบเมื่อรับข้อมูล
[in] pktInfo
ตัวชี้แบบอ่านอย่างเดียวที่ไปยังออบเจ็กต์ IPPacketInfo

รัฐ

 State

สถานะของ WeaveMessageLayer

พร็อพเพอร์ตี้
kState_Initialized

ระบุเมื่อ WeaveMessageLayer เริ่มต้น

kState_Initializing

ระบุเมื่อ WeaveMessageLayer อยู่ในกระบวนการเริ่มต้น

kState_NotInitialized

ระบุเมื่อ WeaveMessageLayer ไม่ได้เริ่มต้น

TunneledMsgReceiveFunct

void(* TunneledMsgReceiveFunct)(WeaveMessageLayer *msgLayer, PacketBuffer *payload)

ฟังก์ชันนี้เป็นโค้ดเรียกกลับเลเยอร์ที่สูงกว่าที่ได้เรียกใช้เมื่อได้รับแพ็กเก็ต Tunneled ผ่านอุโมงค์ UDP ภายใน

รายละเอียด
พารามิเตอร์
[in] msgLayer
ตัวชี้ไปยังออบเจ็กต์ WeaveMessageLayer
[in] payload
ชี้ไปที่ข้อความ PacketBuffer ที่มีแพ็กเก็ต Tunnel ที่ได้รับแล้ว

แอตทริบิวต์สาธารณะ

AppState

void * AppState

ตัวชี้ไปยังออบเจ็กต์สถานะเฉพาะแอปพลิเคชัน

ExchangeMgr

WeaveExchangeManager * ExchangeMgr

[อ่านอย่างเดียว] ออบเจ็กต์ WeaveExchangeManager ที่เกี่ยวข้อง

FabricState

WeaveFabricState * FabricState

[อ่านอย่างเดียว] ออบเจ็กต์ WeaveFabricState ที่เกี่ยวข้อง

IncomingConIdleTimeout

uint32_t IncomingConIdleTimeout

ระยะหมดเวลาเนื่องจากไม่มีการใช้งานเริ่มต้น (เป็นมิลลิวินาที) สำหรับการเชื่อมต่อขาเข้า

Inet

InetLayer * Inet

[อ่านอย่างเดียว] ออบเจ็กต์ InetLayer ที่เกี่ยวข้อง

IsListening

bool IsListening

[อ่านอย่างเดียว] เป็นจริงหากกําลังฟังการเชื่อมต่อ/ข้อความที่เข้ามาใหม่ หากไม่เป็นเช่นนั้นจะเป็นเท็จ

OnAcceptError

AcceptErrorFunct OnAcceptError

OnConnectionReceived

ConnectionReceiveFunct OnConnectionReceived

OnMessageReceived

MessageReceiveFunct OnMessageReceived

OnReceiveError

ReceiveErrorFunct OnReceiveError

OnUDPTunneledMessageReceived

TunneledMsgReceiveFunct OnUDPTunneledMessageReceived

SecurityMgr

WeaveSecurityManager * SecurityMgr

[อ่านอย่างเดียว] ออบเจ็กต์ WeaveSecurityManager ที่เกี่ยวข้อง

รัฐ

uint8_t State

[อ่านอย่างเดียว] สถานะของออบเจ็กต์ WeaveMessageLayer

SystemLayer

System::Layer * SystemLayer

mDropMessage

bool mDropMessage

ภายในและสำหรับการแก้ไขข้อบกพร่องเท่านั้น เมื่อตั้งค่า WeaveMessageLayer จะลบข้อความและส่งคืน

ฟังก์ชันสาธารณะ

ClearUnsecuredConnectionListener

WEAVE_ERROR ClearUnsecuredConnectionListener(
  ConnectionReceiveFunct oldOnUnsecuredConnectionReceived,
  CallbackRemovedFunct newOnUnsecuredConnectionCallbacksRemoved
)

CloseEndpoints

WEAVE_ERROR CloseEndpoints(
  void
)

ปิดปลายทาง TCP และ UDP ที่เปิดอยู่ทั้งหมด

จากนั้นให้ล้มเลิก WeaveConnections ที่เปิดอยู่ และปิดออบเจ็กต์ WeaveConnectionTunnel ที่เปิดอยู่

โปรดดูเพิ่มเติมที่
ปิดการทำงาน()

CreateTunnel

WEAVE_ERROR CreateTunnel(
  WeaveConnectionTunnel **tunPtr,
  WeaveConnection & conOne,
  WeaveConnection & conTwo,
  uint32_t inactivityTimeoutMS
)

สร้าง WeaveConnectionTunnel โดยเชื่อมต่อ WeaveConnections ที่ระบุ 2 รายการเข้าด้วยกัน

เมื่อสร้างสําเร็จ ระบบจะส่ง TCPEndPoints ที่ตรงกับออบเจ็กต์ WeaveConnection ของคอมโพเนนต์ไปยัง WeaveConnectionTunnel มิฉะนั้น WeaveConnections จะปิด

รายละเอียด
พารามิเตอร์
[out] tunPtr
ตัวชี้ไปยังตัวชี้ของออบเจ็กต์ WeaveConnectionTunnel
[in] conOne
การอ้างอิงไปยังออบเจ็กต์ WeaveConnection รายการแรก
[in] conTwo
การอ้างอิงไปยังออบเจ็กต์ WeaveConnection รายการที่ 2
[in] inactivityTimeoutMS
เวลาสูงสุดเป็นมิลลิวินาทีที่อุโมงค์การเชื่อมต่อ Weave ไม่มีการใช้งาน
แสดงผลค่า
WEAVE_NO_ERROR
การสร้าง WeaveConnectionTunnel ที่ประสบความสำเร็จ
WEAVE_ERROR_INCORRECT_STATE
หากออบเจ็กต์ WeaveConnection ของคอมโพเนนต์ของ WeaveConnectionTunnel ไม่อยู่ในสถานะที่ถูกต้อง
WEAVE_ERROR_NO_MEMORY
หากสร้างออบเจ็กต์ WeaveConnectionTunnel ใหม่ไม่ได้

DecodeHeader

WEAVE_ERROR DecodeHeader(
  PacketBuffer *msgBuf,
  WeaveMessageInfo *msgInfo,
  uint8_t **payloadStart
)

ถอดรหัสส่วนหัวของเลเยอร์ Weave Message จากข้อความ Weave ที่ได้รับ

รายละเอียด
พารามิเตอร์
[in] msgBuf
ตัวชี้ไปยังออบเจ็กต์ PacketBuffer ที่มีข้อความ Weave อยู่
[in] msgInfo
ตัวชี้ไปยังออบเจ็กต์ WeaveMessageInfo ซึ่งจะรับข้อมูลเกี่ยวกับข้อความ
[out] payloadStart
ตัวชี้ไปยังตัวชี้ที่ไปยังตำแหน่งในบัฟเฟอร์ข้อความหลังจากที่ถอดรหัสเสร็จสมบูรณ์
แสดงผลค่า
WEAVE_NO_ERROR
เมื่อถอดรหัสส่วนหัวของข้อความสำเร็จ
WEAVE_ERROR_INVALID_MESSAGE_LENGTH
หากบัฟเฟอร์ข้อความที่ส่งผ่านมีความยาวไม่ถูกต้อง
WEAVE_ERROR_UNSUPPORTED_MESSAGE_VERSION
หากระบบไม่รองรับเวอร์ชันรูปแบบส่วนหัว Weave Message

EncodeMessage

WEAVE_ERROR EncodeMessage(
  WeaveMessageInfo *msgInfo,
  PacketBuffer *msgBuf,
  WeaveConnection *con,
  uint16_t maxLen,
  uint16_t reserve
)

เข้ารหัสส่วนหัว WeaveMessageLayer ลงใน PacketBuffer

รายละเอียด
พารามิเตอร์
[in] msgInfo
ตัวชี้ไปยังออบเจ็กต์ WeaveMessageInfo ที่มีข้อมูลเกี่ยวกับข้อความที่จะเข้ารหัส
[in] msgBuf
ตัวชี้ไปยังออบเจ็กต์ PacketBuffer ที่จะคงข้อความ Weave ไว้
[in] con
ตัวชี้ไปยังออบเจ็กต์ WeaveConnection
[in] maxLen
ความยาวสูงสุดของข้อความ Weave ที่เข้ารหัส
[in] reserve
พื้นที่ที่สงวนไว้ก่อนเพย์โหลดสำหรับเก็บส่วนหัวข้อความ Weave
แสดงผลค่า
WEAVE_NO_ERROR
เมื่อเข้ารหัสข้อความได้สำเร็จ
WEAVE_ERROR_UNSUPPORTED_MESSAGE_VERSION
หากระบบไม่รองรับเวอร์ชันรูปแบบส่วนหัว Weave Message
WEAVE_ERROR_INVALID_MESSAGE_LENGTH
หากความยาวของเพย์โหลดในบัฟเฟอร์ข้อความเป็น 0
WEAVE_ERROR_UNSUPPORTED_ENCRYPTION_TYPE
หากระบบไม่รองรับประเภทการเข้ารหัสในส่วนหัวของข้อความ
WEAVE_ERROR_MESSAGE_TOO_LONG
หากข้อความที่เข้ารหัสยาวกว่าค่าสูงสุดที่ขอ
WEAVE_ERROR_BUFFER_TOO_SMALL
หากมีพื้นที่ไม่เพียงพอก่อนหรือหลังเพย์โหลดของข้อความ
other
ข้อผิดพลาดที่สร้างขึ้นโดยออบเจ็กต์สถานะ Fabric เมื่อดึงข้อมูลสถานะเซสชัน

EncodeMessage

WEAVE_ERROR EncodeMessage(
  const IPAddress & destAddr,
  uint16_t destPort,
  InterfaceId sendIntId,
  WeaveMessageInfo *msgInfo,
  PacketBuffer *payload
)

เข้ารหัสส่วนหัวของเลเยอร์ Weave Message ลงใน PacketBuffer

รายละเอียด
พารามิเตอร์
[in] destAddr
ที่อยู่ IP ปลายทาง
[in] destPort
พอร์ตปลายทาง
[in] sendIntId
อินเทอร์เฟซที่จะส่งข้อความ Weave
[in] msgInfo
ตัวชี้ไปยังออบเจ็กต์ WeaveMessageInfo
[in] payload
ตัวชี้ไปยังออบเจ็กต์ PacketBuffer ที่จะคงข้อความ Weave ไว้
แสดงผลค่า
WEAVE_NO_ERROR
เมื่อการเข้ารหัสข้อความ Weave สำเร็จ
WEAVE_ERROR_UNSUPPORTED_MESSAGE_VERSION
หากระบบไม่รองรับเวอร์ชัน Weave Message
WEAVE_ERROR_INVALID_MESSAGE_LENGTH
หากความยาวของเพย์โหลดในบัฟเฟอร์ข้อความเป็น 0
WEAVE_ERROR_UNSUPPORTED_ENCRYPTION_TYPE
หากระบบไม่รองรับประเภทการเข้ารหัส
WEAVE_ERROR_MESSAGE_TOO_LONG
หากข้อความที่เข้ารหัสยาวกว่าค่าสูงสุดที่ขอ
WEAVE_ERROR_BUFFER_TOO_SMALL
หากมีพื้นที่ไม่เพียงพอก่อนหรือหลังเพย์โหลดของข้อความ
other
ข้อผิดพลาดที่สร้างขึ้นโดยออบเจ็กต์สถานะ Fabric เมื่อดึงข้อมูลสถานะเซสชัน

EphemeralUDPPortEnabled

bool EphemeralUDPPortEnabled(
  void
) const

ตรวจสอบว่าควรส่งการแลกเปลี่ยน Weave UDP ที่เริ่มต้นในเครื่องจากพอร์ตแหล่งที่มา UDP ชั่วคราวหรือไม่

GetConnectionPoolStats

void GetConnectionPoolStats(
  nl::Weave::System::Stats::count_t & aOutInUse
) const

รับจำนวน WeaveConnections ที่ใช้งานอยู่และขนาดของพูล

รายละเอียด
พารามิเตอร์
[out] aOutInUse
การอ้างอิง size_t ซึ่งจัดเก็บจำนวนการเชื่อมต่อที่ใช้งานอยู่

IPv4ListenEnabled

bool IPv4ListenEnabled(
  void
) const

ตรวจสอบว่ามีการกำหนดค่า WeaveMessageLayer ให้รับการสื่อสารขาเข้าผ่าน IPv4 หรือไม่

IPv6ListenEnabled

bool IPv6ListenEnabled(
  void
) const

ตรวจสอบว่ามีการกำหนดค่า WeaveMessageLayer ให้รับการสื่อสารขาเข้าผ่าน IPv4 หรือไม่

เริ่มต้น

WEAVE_ERROR Init(
  InitContext *context
)

เริ่มต้นออบเจ็กต์เลเยอร์ข้อความ Weave

รายละเอียด
พารามิเตอร์
[in] context
ตัวชี้ไปยังออบเจ็กต์ InitContext
แสดงผลค่า
WEAVE_NO_ERROR
ในการเริ่มต้นที่ประสบความสำเร็จ
WEAVE_ERROR_INVALID_ARGUMENT
หากออบเจ็กต์ InitContext ที่ส่งเป็น NULL
WEAVE_ERROR_INCORRECT_STATE
หากสถานะของออบเจ็กต์ WeaveMessageLayer ไม่ถูกต้อง
other
ข้อผิดพลาดที่เกิดจากเลเยอร์ Inet ที่ต่ำกว่าระหว่างการสร้างปลายทาง

IsBoundToLocalIPv4Address

bool IsBoundToLocalIPv4Address(
  void
) const

ตรวจสอบว่า WeaveMessageLayer เชื่อมโยงกับที่อยู่ IPv4 ในเครื่องหรือไม่

IsBoundToLocalIPv6Address

bool IsBoundToLocalIPv6Address(
  void
) const

ตรวจสอบว่า WeaveMessageLayer เชื่อมโยงกับที่อยู่ IPv6 ในเครื่องหรือไม่

IsMessageLayerActive

bool IsMessageLayerActive(
  void
)

NewConnection

WeaveConnection * NewConnection(
  void
)

สร้างออบเจ็กต์ WeaveConnection ใหม่จากพูล

รายละเอียด
การส่งคืน
ตัวชี้ไปยังออบเจ็กต์ WeaveConnection ที่สร้างขึ้นใหม่ หากสำเร็จ มิฉะนั้นจะเป็น NULL

NewConnectionTunnel

WeaveConnectionTunnel * NewConnectionTunnel(
  void
)

สร้างออบเจ็กต์ WeaveConnectionTunnel ใหม่จากพูล

รายละเอียด
การส่งคืน
ตัวชี้ไปยังออบเจ็กต์ WeaveConnectionTunnel ที่สร้างขึ้นใหม่ หากสำเร็จ มิฉะนั้นจะเป็น NULL

ReEncodeMessage

WEAVE_ERROR ReEncodeMessage(
  PacketBuffer *buf
)

RefreshEndpoints

WEAVE_ERROR RefreshEndpoints(
  void
)

รีเฟรชปลายทาง InetLayer ตามสถานะปัจจุบันของอินเทอร์เฟซเครือข่ายของระบบ

รายละเอียด
แสดงผลค่า
WEAVE_NO_ERROR
เมื่อรีเฟรชปลายทางสำเร็จ
InetLayer
โดยอิงตามการเรียกเพื่อสร้างปลายทาง TCP/UDP

ResendMessage

WEAVE_ERROR ResendMessage(
  WeaveMessageInfo *msgInfo,
  PacketBuffer *msgBuf
)

ส่งข้อความ Weave ที่เข้ารหัสอีกครั้งโดยใช้ปลายทาง Inetlayer UDP ที่เกี่ยวข้อง

รายละเอียด
พารามิเตอร์
[in] msgInfo
ตัวชี้ไปยังออบเจ็กต์ WeaveMessageInfo
[in] payload
ตัวชี้ไปยังออบเจ็กต์ PacketBuffer ซึ่งมีข้อความ Weave ที่เข้ารหัส
แสดงผลค่า
WEAVE_NO_ERROR
เมื่อส่งข้อความไปยังเลเยอร์เครือข่ายสำเร็จ
errors
สร้างขึ้นจากปลายทาง UDP เลเยอร์ Inet ที่ต่ำกว่าระหว่างการส่ง

ResendMessage

WEAVE_ERROR ResendMessage(
  const IPAddress & destAddr,
  WeaveMessageInfo *msgInfo,
  PacketBuffer *msgBuf
)

ส่งข้อความ Weave ที่เข้ารหัสอีกครั้งโดยใช้ปลายทาง Inetlayer UDP ที่เกี่ยวข้อง

รายละเอียด
พารามิเตอร์
[in] destAddr
ที่อยู่ IP ปลายทาง
[in] msgInfo
ตัวชี้ไปยังออบเจ็กต์ WeaveMessageInfo
[in] payload
ตัวชี้ไปยังออบเจ็กต์ PacketBuffer ซึ่งมีข้อความ Weave ที่เข้ารหัส
แสดงผลค่า
WEAVE_NO_ERROR
เมื่อส่งข้อความไปยังเลเยอร์เครือข่ายสำเร็จ
errors
สร้างขึ้นจากปลายทาง UDP เลเยอร์ Inet ที่ต่ำกว่าระหว่างการส่ง

ResendMessage

WEAVE_ERROR ResendMessage(
  const IPAddress & destAddr,
  uint16_t destPort,
  WeaveMessageInfo *msgInfo,
  PacketBuffer *msgBuf
)

ส่งข้อความ Weave ที่เข้ารหัสอีกครั้งโดยใช้ปลายทาง Inetlayer UDP ที่เกี่ยวข้อง

รายละเอียด
พารามิเตอร์
[in] destAddr
ที่อยู่ IP ปลายทาง
[in] destPort
พอร์ตปลายทาง
[in] msgInfo
ตัวชี้ไปยังออบเจ็กต์ WeaveMessageInfo
[in] payload
ตัวชี้ไปยังออบเจ็กต์ PacketBuffer ซึ่งมีข้อความ Weave ที่เข้ารหัส
แสดงผลค่า
WEAVE_NO_ERROR
เมื่อส่งข้อความไปยังเลเยอร์เครือข่ายสำเร็จ
errors
สร้างขึ้นจากปลายทาง UDP เลเยอร์ Inet ที่ต่ำกว่าระหว่างการส่ง

ResendMessage

WEAVE_ERROR ResendMessage(
  const IPAddress & destAddr,
  uint16_t destPort,
  InterfaceId interfaceId,
  WeaveMessageInfo *msgInfo,
  PacketBuffer *msgBuf
)

ส่งข้อความ Weave ที่เข้ารหัสอีกครั้งโดยใช้ปลายทาง Inetlayer UDP ที่เกี่ยวข้อง

หมายเหตุ: - หากไม่ได้ระบุที่อยู่ปลายทาง ให้ลองระบุจากตัวระบุโหนดในส่วนหัวของข้อความ จะล้มเหลวหากยังทำไม่ได้ - หากที่อยู่ปลายทางเป็นที่อยู่ Fabric สำหรับ Fabric ท้องถิ่น และผู้โทรไม่ได้ระบุรหัสโหนดปลายทาง ให้ดึงข้อมูลจากที่อยู่ปลายทาง

รายละเอียด
พารามิเตอร์
[in] aDestAddr
ที่อยู่ IP ปลายทาง
[in] destPort
พอร์ตปลายทาง
[in] interfaceId
อินเทอร์เฟซที่จะส่งข้อความ Weave
[in] msgInfo
ตัวชี้ไปยังออบเจ็กต์ WeaveMessageInfo
[in] payload
ตัวชี้ไปยังออบเจ็กต์ PacketBuffer ซึ่งมีข้อความ Weave ที่เข้ารหัส
แสดงผลค่า
WEAVE_NO_ERROR
เมื่อส่งข้อความไปยังเลเยอร์เครือข่ายสำเร็จ
errors
สร้างขึ้นจากปลายทาง UDP เลเยอร์ Inet ที่ต่ำกว่าระหว่างการส่ง

SendMessage

WEAVE_ERROR SendMessage(
  WeaveMessageInfo *msgInfo,
  PacketBuffer *msgBuf
)

ส่งข้อความ Weave โดยใช้ปลายทาง Inetlayer UDP พื้นฐานหลังจากเข้ารหัส

รายละเอียด
พารามิเตอร์
[in] msgInfo
ตัวชี้ไปยังออบเจ็กต์ WeaveMessageInfo ที่มีข้อมูลเกี่ยวกับข้อความที่ส่ง
[in] payload
ตัวชี้ไปยังออบเจ็กต์ PacketBuffer ซึ่งมีข้อความ Weave ที่เข้ารหัส
แสดงผลค่า
WEAVE_NO_ERROR
เมื่อส่งข้อความไปยังเลเยอร์เครือข่ายสำเร็จ
errors
สร้างขึ้นจากปลายทาง UDP เลเยอร์ Inet ที่ต่ำกว่าระหว่างการส่ง

SendMessage

WEAVE_ERROR SendMessage(
  const IPAddress & destAddr,
  WeaveMessageInfo *msgInfo,
  PacketBuffer *msgBuf
)

ส่งข้อความ Weave โดยใช้ปลายทาง Inetlayer UDP พื้นฐานหลังจากเข้ารหัส

หมายเหตุ: - พอร์ตปลายทางที่ใช้คือ WEAVE_PORT - หากยังไม่ได้ระบุที่อยู่ปลายทาง ให้ลองพิจารณาจากตัวระบุโหนดในส่วนหัวของข้อความ จะล้มเหลวหากยังทำไม่ได้

- หากที่อยู่ปลายทางเป็นที่อยู่ Fabric สำหรับ Fabric ท้องถิ่น และผู้โทรไม่ได้ระบุรหัสโหนดปลายทาง ให้ดึงข้อมูลจากที่อยู่ปลายทาง

รายละเอียด
พารามิเตอร์
[in] destAddr
ที่อยู่ IP ปลายทาง
[in] msgInfo
ตัวชี้ไปยังออบเจ็กต์ WeaveMessageInfo ที่มีข้อมูลเกี่ยวกับข้อความที่ส่ง
[in] payload
ตัวชี้ไปยังออบเจ็กต์ PacketBuffer ซึ่งมีข้อความ Weave ที่เข้ารหัส
แสดงผลค่า
WEAVE_NO_ERROR
เมื่อส่งข้อความไปยังเลเยอร์เครือข่ายสำเร็จ
errors
สร้างขึ้นจากปลายทาง UDP เลเยอร์ Inet ที่ต่ำกว่าระหว่างการส่ง

SendMessage

WEAVE_ERROR SendMessage(
  const IPAddress & destAddr,
  uint16_t destPort,
  InterfaceId sendIntfId,
  WeaveMessageInfo *msgInfo,
  PacketBuffer *msgBuf
)

ส่งข้อความ Weave โดยใช้ปลายทาง Inetlayer UDP พื้นฐานหลังจากเข้ารหัส

หมายเหตุ: - หากไม่ได้ระบุที่อยู่ปลายทาง ให้ลองระบุจากตัวระบุโหนดในส่วนหัวของข้อความ จะล้มเหลวหากยังทำไม่ได้ - หากที่อยู่ปลายทางเป็นที่อยู่ Fabric สำหรับ Fabric ท้องถิ่น และผู้โทรไม่ได้ระบุรหัสโหนดปลายทาง ให้ดึงข้อมูลจากที่อยู่ปลายทาง

รายละเอียด
พารามิเตอร์
[in] aDestAddr
ที่อยู่ IP ปลายทาง
[in] destPort
พอร์ตปลายทาง
[in] sendIntfId
อินเทอร์เฟซที่จะส่งข้อความ Weave
[in] msgInfo
ตัวชี้ไปยังออบเจ็กต์ WeaveMessageInfo ที่มีข้อมูลเกี่ยวกับข้อความที่ส่ง
[in] payload
ตัวชี้ไปยังออบเจ็กต์ PacketBuffer ซึ่งมีข้อความ Weave ที่เข้ารหัส
แสดงผลค่า
WEAVE_NO_ERROR
เมื่อส่งข้อความไปยังเลเยอร์เครือข่ายสำเร็จ
WEAVE_ERROR_INVALID_ADDRESS
ถ้าไม่ได้ระบุ destAddr หรือไม่สามารถระบุจากรหัสโหนดปลายทาง
errors
สร้างขึ้นจากปลายทาง UDP เลเยอร์ Inet ที่ต่ำกว่าระหว่างการส่ง

SendUDPTunneledMessage

WEAVE_ERROR SendUDPTunneledMessage(
  const IPAddress & destAddr,
  WeaveMessageInfo *msgInfo,
  PacketBuffer *msgBuf
)

ฟังก์ชันเพื่อส่งแพ็กเก็ต Tunneled ผ่านอุโมงค์ UDP ภายใน

ส่งข้อความข้อมูล IPv6 แบบ Tunnel ผ่าน UDP

รายละเอียด
พารามิเตอร์
[in] msgInfo
ตัวชี้ไปยังออบเจ็กต์ WeaveMessageInfo
[in] destAddr
IPAddress ของปลายทางอุโมงค์ข้อมูล UDP
[in] msgBuf
ตัวชี้ไปยังออบเจ็กต์ PacketBuffer ที่ถือแพ็กเก็ตที่จะส่ง
แสดงผลค่า
WEAVE_NO_ERROR
เมื่อส่งข้อความไปยังเลเยอร์เครือข่ายสำเร็จ
WEAVE_ERROR_INVALID_ADDRESS
ถ้าไม่ได้ระบุ destAddr หรือไม่สามารถระบุจากรหัสโหนดปลายทาง
errors
สร้างขึ้นจากปลายทาง UDP เลเยอร์ Inet ที่ต่ำกว่าระหว่างการส่ง

SetSignalMessageLayerActivityChanged

void SetSignalMessageLayerActivityChanged(
  MessageLayerActivityChangeHandlerFunct messageLayerActivityChangeHandler
)

ตั้งค่าเครื่องจัดการแอปพลิเคชันที่จะถูกเรียกทุกครั้งที่กิจกรรมของชั้นข้อความเปลี่ยนแปลง

กล่าวอย่างเจาะจงคือ แอปพลิเคชันจะได้รับการแจ้งเตือนทุกครั้ง:

  • จำนวนการเปลี่ยนแปลงของ การซื้อขายเปิด
  • จำนวนคำขอการซิงค์สำหรับตัวนับข้อความที่รอการดำเนินการเปลี่ยนจาก 0 เป็น 1 เป็นอย่างน้อย และกลับไปเป็น 0 เครื่องจัดการจะทำหน้าที่เป็นสัญญาณทั่วไปที่ระบุว่ามีการสนทนา Weave ที่ดำเนินอยู่หรือการตอบกลับที่รอดำเนินการหรือไม่ ต้องตั้งค่าตัวแฮนเดิลหลังจากเริ่มต้น WeaveMessageLayer การปิด WeaveMessageLayer จะล้างตัวแฮนเดิลปัจจุบัน

รายละเอียด
พารามิเตอร์
[in] messageLayerActivityChangeHandler
ตัวชี้ไปยังฟังก์ชันที่จะเรียกใช้เมื่อมีการเปลี่ยนแปลงกิจกรรมเลเยอร์ข้อความ
แสดงผลค่า
None.

SetTCPListenEnabled

void SetTCPListenEnabled(
  bool val
)

เปิดหรือปิดใช้การฟังสำหรับการเชื่อมต่อ TCP ขาเข้าใน WeaveMessageLayer

หมายเหตุ: ต้องเรียกใช้ RefreshEndpoints() หลังจากเปลี่ยนสถานะการฟัง TCP

SetUDPListenEnabled

void SetUDPListenEnabled(
  bool val
)

เปิดหรือปิดใช้การฟังข้อความ UDP ขาเข้าใน WeaveMessageLayer

หมายเหตุ: ต้องเรียก RefreshEndpoints() หลังจากสถานะการฟัง UDP เปลี่ยนไป

SetUnsecuredConnectionListener

WEAVE_ERROR SetUnsecuredConnectionListener(
  ConnectionReceiveFunct newOnUnsecuredConnectionReceived,
  CallbackRemovedFunct newOnUnsecuredConnectionCallbacksRemoved,
  bool force,
  void *listenerState
)

ปิดการทำงาน

WEAVE_ERROR Shutdown(
  void
)

ปิด WeaveMessageLayer

ปิดปลายทางของเลเยอร์ Inet ที่เปิดอยู่ทั้งหมด รีเซ็ตโค้ดเรียกกลับของเลเยอร์ที่สูงขึ้น ตัวแปรสมาชิก และออบเจ็กต์ทั้งหมด การเรียก Shutdown() จะยุติออบเจ็กต์ WeaveMessageLayer

TCPListenEnabled

bool TCPListenEnabled(
  void
) const

ตรวจสอบว่ามีการกำหนดค่า WeaveMessageLayer ให้รับการเชื่อมต่อ TCP ขาเข้าหรือไม่

UDPListenEnabled

bool UDPListenEnabled(
  void
) const

ตรวจสอบว่ามีการกำหนดค่า WeaveMessageLayer ให้รอรับข้อความ UDP ขาเข้าหรือไม่

UnsecuredListenEnabled

bool UnsecuredListenEnabled(
  void
) const

เปิดหรือปิดการเริ่มการแลกเปลี่ยน Weave UDP จากพอร์ตแหล่งที่มา UDP ชั่วคราว

หมายเหตุ: ต้องเรียกใช้ RefreshEndpoints() หลังจากเปลี่ยนสถานะพอร์ตชั่วคราวแล้ว ตรวจสอบว่าเปิดใช้การฟังที่ไม่ปลอดภัยหรือไม่

WeaveMessageLayer

 WeaveMessageLayer(
  void
)

ตัวสร้างเลเยอร์ Weave Message

ฟังก์ชันแบบคงที่แบบสาธารณะ

GetMaxWeavePayloadSize

uint32_t GetMaxWeavePayloadSize(
  const PacketBuffer *msgBuf,
  bool isUDP,
  uint32_t udpMTU
)

รับขนาดเพย์โหลด Weave สูงสุดสำหรับการกำหนดค่าข้อความและ PacketBuffer ที่ระบุ

ขนาดเพย์โหลดสูงสุดที่แสดงผลจะไม่เกินพื้นที่ว่างที่มีอยู่สำหรับเพย์โหลดภายใน PacketBuffer ที่ระบุ

หากข้อความเป็น UDP ขนาดเพย์โหลดสูงสุดที่แสดงผลจะไม่ส่งผลให้มีข้อความ Weave ที่จะไม่สูงกว่า UDP MTU ที่ระบุ

สุดท้าย ขนาดเพย์โหลดสูงสุดที่แสดงผลจะไม่ส่งผลให้ข้อความ Weave มีขนาดเกินขนาดสูงสุดของข้อความ Weave

รายละเอียด
พารามิเตอร์
[in] msgBuf
ตัวชี้ไปยัง PacketBuffer ซึ่งจะเขียนเปย์โหลดของข้อความ
[in] isUDP
จริง หากข้อความเป็นข้อความ UDP
[in] udpMTU
ขนาดของ UDP MTU ละเว้นหาก isUDP เป็นเท็จ
การส่งคืน
เปย์โหลด Weave สูงสุด

GetPeerDescription

void GetPeerDescription(
  char *buf,
  size_t bufSize,
  uint64_t nodeId,
  const IPAddress *addr,
  uint16_t port,
  InterfaceId interfaceId,
  const WeaveConnection *con
)

สร้างสตริงที่อธิบายโหนดเพียร์และข้อมูลที่อยู่ / การเชื่อมต่อที่เกี่ยวข้อง

สตริงที่สร้างขึ้นมีรูปแบบดังต่อไปนี้ 

 ([]:%, con )

รายละเอียด
พารามิเตอร์
[in] buf
ตัวชี้ไปยังบัฟเฟอร์ที่ควรเขียนสตริง บัฟเฟอร์ที่ให้ไว้ควรมีขนาดใหญ่อย่างน้อยเท่ากับ kWeavePeerDescription_MaxLength หากบัฟเฟอร์ที่เล็กกว่านั้น สตริงจะถูกตัดให้พอดี ผลลัพธ์จะมีอักขระสิ้นสุดค่าว่างในทุกกรณี
[in] bufSize
ขนาดของบัฟเฟอร์ที่ชี้ที่ buf
[in] nodeId
รหัสโหนดที่จะพิมพ์
[in] addr
ตัวชี้ไปยังที่อยู่ IP ที่จะพิมพ์ หรือ NULL ถ้าไม่ควรพิมพ์ที่อยู่ IP
[in] port
หมายเลขพอร์ต IP ที่จะพิมพ์ หมายเลขพอร์ตจะไม่พิมพ์หาก Addr เป็น NULL
[in] interfaceId
InterfaceId ที่ระบุอินเทอร์เฟซที่จะพิมพ์ สตริงเอาต์พุตจะมีชื่อของอินเทอร์เฟซตามสแต็กเครือข่ายที่อยู่เบื้องหลัง จะไม่มีการพิมพ์ชื่ออินเทอร์เฟซหาก InterfaceId คือ INET_NULL_INTERFACEID หรือ Addr มีค่าเป็น NULL
[in] con
ตัวชี้ไปยังออบเจ็กต์ WeaveConnection ที่ควรพิมพ์รหัสการบันทึก หรือ NULL ถ้าไม่ควรพิมพ์รหัสการเชื่อมต่อ

GetPeerDescription

void GetPeerDescription(
  char *buf,
  size_t bufSize,
  const WeaveMessageInfo *msgInfo
)

สร้างสตริงที่อธิบายโหนดเพียร์ตามข้อมูลที่เชื่อมโยงกับข้อความที่ได้รับจากการเพียร์

รายละเอียด
พารามิเตอร์
[in] buf
ตัวชี้ไปยังบัฟเฟอร์ที่ควรเขียนสตริง บัฟเฟอร์ที่ให้ไว้ควรมีขนาดใหญ่อย่างน้อยเท่ากับ kWeavePeerDescription_MaxLength หากบัฟเฟอร์ที่เล็กกว่านั้น สตริงจะถูกตัดให้พอดี ผลลัพธ์จะมีอักขระสิ้นสุดค่าว่างในทุกกรณี
[in] bufSize
ขนาดของบัฟเฟอร์ที่ชี้ที่ buf
[in] msgInfo
ตัวชี้ไปยังโครงสร้าง WeaveMessageInfo ที่มีข้อมูลเกี่ยวกับข้อความ