WinNetworkBrowserEnumerateTrustees Method Content Studio 5.7 SDK
Content Studio Web Content Management System

[This is preliminary documentation and is subject to change.]

Returns a list of trustees from the network of from the local machine. The document is a complete list of all documents that exists but grouped in pages. Avoid using this method to list users in domains with a large number of users.

Namespace: ContentStudio.Security
Assembly: CSServer5 (in CSServer5.dll) Version: 5.7.5016.0 (5.7.5016.0)
Syntax
Copy
public string EnumerateTrustees(
	WinNetworkBrowserDisplayLevels level,
	string domainName,
	WinNetworkBrowserDomainNameTypes domainNameType,
	int pageSize,
	out int pageCount,
	out int trusteesFound,
	bool includeDescription
)

Parameters

level
Type: ContentStudio.SecurityWinNetworkBrowserDisplayLevels
Indicates the type of trustee to get. This parameter must be one of the members of the DisplayLevels
domainName
Type: SystemString
The name of the domain to search. This can be the local machine name or a domain. If DomainName is empty or null the local machine is assumed
domainNameType
Type: ContentStudio.SecurityWinNetworkBrowserDomainNameTypes
The type of domain name entered. Can be either a NetBIOS name or a DNS name or any.
pageSize
Type: SystemInt32
The size of the paged data to return
pageCount
Type: SystemInt32
The number of pages found
trusteesFound
Type: SystemInt32
The number of trustees found
includeDescription
Type: SystemBoolean
Set to true to return description in addition to name and id

Return Value

Type: String
Xml
Copy
<root>
   <page number="1"> 
     <trustee name="" desc="" fullname="" flags=id=&quot;&quot; type=""/>
     <!--more trustes -->
   </page>
   <!--more pages -->
   <status>0</status>
   <statustext></statustext>
   <pagecount></pagecount>
   <recordcount></recordcount>
</root>
Exceptions
ExceptionCondition
Win32ExceptionA network error occurred while attempting to enumerate trustees.
ArgumentOutOfRangeExceptionA the level or DomainNameTypes parameters has av value that is out of the allowed range.
Remarks
The number of entries returned by this function depends on the security descriptor located on the root domain object. The API will return the entire set of entries in the domain or just a subset, depending on the access privileges of the Content Studio runtime. The ACE used to control this behavior is "SAM-Enumerate-Entire-Domain", and is granted to Authenticated Users by default. Administrators can modify this setting to allow users to enumerate the entire domain.
See Also

Reference

WinNetworkBrowser Class
ContentStudio.Security Namespace