MGMT_FindFirstElement

Determines if the complete main XML element has been received in a write operation. This function builds up an internal buffer that holds the entire XML stream until the main element is closed.

Service:VFS

Syntax

#include <nssPubs.h>

STATUS MGMT_FindFirstElement (
   VirtInfo_s         *virtInfo,
   utf8_t             *tagName,
   NINT                bufferLength,
   BYTE               *buffer,
   NINT                offset,
   XML_ElementInfo_s  *element);

Parameters

virtInfo: Points to a structure that is unique for each open instance of the virtual file. It contains information about the state of the file, as well as the results buffer. Usually, you will not change the contents of this structure but simply pass it to other functions.
tagName: Points to the name of the main element of the XML that is to be parsed.
bufferLength: Specifies the length of the data that is being passed to the write function.
buffer: Points to the data that is being passed to the write function.
offset: Specifies the offset of the write.
element: Points to a structure that contains the results of the XML element parsing. It includes a pionter to the start of the element's data and to the end of the element's data.

Return Values

The return status should either be zOK or a valid NSS error code.