AddRootNode Method
Topic Last Modified: 2006-06-13
The AddRootNode method adds a node to the TreeView control using a URL to a top-level hierarchy in the Exchange store.
Applies To
Syntax
Function AddRootNode( ByVal URL As String,
ByVal displayname As String,
ByVal [Expand As Boolean],
ByVal [Username As String],
ByVal [Password As String])
HRESULT AddRootNode
(
BSTR URL,
BSTR displayname,
VARIANT_BOOL* Expand,
BSTR* Username,
BSTR* Password
);
Parameters
URL
A URL to a public or private top-level hierarchy in the Exchange store. The Exchange store folder must be a virtual directory.Note
Do not UTF-8 encode the URL for this method.
- displayname
A display name for a specific node; this name does not correspond to any Exchange store property.
- Expand
A TRUE value expands any child nodes when the node is selected.
- Username
A username if authentication is required.
- Password
A password if authentication is required.
Return Value
Returns S_OK if successful, or an error value otherwise.
Remarks
This method is typically used in the Microsoft® Visual Basic® form load event, so that the control is populated with one or more nodes at run time. Otherwise you add a root node based on a URL that is typed by the user.
Example
The following example adds a root node to the TreeView control.
Dim strURL, strDsp As String
strURL = InputBox("Enter root url:")
strDsp = InputBox("Enter display name:")
EXTV1.AddRootNode strURL, strDsp, True