DefaultNamingContext

(Engine-Level Function)

Description: Returns the string value of the LDAP default naming context for the host machine domain.
Returns: Text
Usage: Steady State only.
Function Groups: Security
Related to:  
Format: DefaultNamingContext()
Parameters: None
Comments:

If the host machine is unable to contact the domain controller invalid is returned, otherwise a string of the form "DC=example,DC=com" is returned

This function is useful only for Active Directory operations.

This function may take some time to complete and will block the caller until it does. Other threads in the VTScada system will continue to run while this function is executing.

Example:

...
  If 1 Main;
  [
    MyContext = DefaultNamingContext();
    ...

In this example, MyContext will contain text similar to "DC=example,DC=com"