GetDirectoryOptions Method (IPISDKOptions interface)



This method returns a NamedValues collection of Directory options currently in effect in the running application.  Each contained NamedValue object represents an option where the Name property is the option name and the Value property is the setting. Before calling this method, the user must first instantiate either the PISDK object and the Servers collection or a ServerManager object.  



The object placeholder is an object expression that evaluates to an IPISDKOptions interface, obtained from a PISDK object.


The options associated with the names in the collection should be treated as booleans and contain 0 for FALSE and a non zero value for TRUE


The values currently managed by this method are:

Setting Description Default
AutoAdd When looking for a server in Servers.Item or ServerManager.Item, if an entry from the Known Servers Table (including checking aliases, etc.) can't be found, create a new Server object and return it. In the case of Servers, there is no request to connect so the only check by default is that the passed name can be resolved to an IP address. For ServerManager, if a connection cannot be made with the new server, an error is returned. True
CheckIP The check for a network resolvable name when performing an "AutoAdd" can be disabled by the "CheckIP" setting . True


Trappable Errors

In addition to generic errors (such as Out of Memory), the following errors may occur:



E_INVALIDARG, E_POINTER Some of the function arguments are not valid.
pseNOSRVRSORSRVRMGR Either Servers or ServerManager must be instantiated first.
Enabling Operational Intelligence