Important:
This is retired content. This content is outdated and is no longer being maintained. It is provided as a courtesy for individuals who are still using these technologies. This content may contain URLs that were valid when originally published, but now link to sites or pages that no longer exist.
A version of this page is also available for
4/8/2010

This method retrieves the contents of a string or URL node.

Syntax

HRESULT GetNodeStringData(
  ULONG 
nodeIndex,
  NodeData* 
pData
);

Parameters

nodeIndex

[in] Zero-based index of the node within the container.

pData

[in, out] On input or output, pointer to the NodeDatastructure containing the string.

Return Value

None.

Remarks

If NodeData::u.url.valis non-null, NodeData::u.url.lengthindicates the length of the supplied buffer. If the supplied buffer is shorter than the total length of the contents of the node, the length of the buffer is copied over and S_FALSE is returned.

If NodeData::u.url.valis NULL, ISdpNodeContainerallocates a buffer, copies the contents over, and assigns the buffer to NodeData::u.url.length. In this case, NodeData::u.url.lengthis set to the length of the buffer. The CoTaskMemFreefunction must be called to free the buffer allocated by ISdpNodeContainer.

Requirements

Header bthapi.h, bthapi.idl
Library Btdrt.lib
Windows Embedded CE Windows CE .NET 4.0 and later
Windows Mobile Windows Mobile Version 5.0 and later

See Also

Reference

NodeData
ISdpNodeContainer

Other Resources

CoTaskMemFree