Home
Engineering
Powerful tools for easy or complex engineering tasks.
System Management
The System Management is the central administrative unit for WinCC OA Systems.
Permission
User Administration
The WinCC OA user administration provides important features for controlling users that use the system. Security is an important issue in the automation technology when controlling highly sensitive systems and it is of utmost importance that the users of the system have only access to the specified area of operation. With the WinCC OA user administration, you can administer users so that they can use the resources effectively without inflicting damage to the system inadvertently or otherwise
User Administration - Control Functions
Windows Specific Functions
getCurrentDomainName()

Version Information
Release Notes, Update information, Certifications and Frequently Asked Questions.
Concepts
Your first step into modern and powerful process visualization.
Deployment
Topics, you need to know, before using WinCC OA.
Security
Go beyond the norm in cybersecurity.
Engineering
Powerful tools for easy or complex engineering tasks.
- Project Administration
  The chapter contains a description of the process monitor as well as the project administration.
- Graphics Editor (GEDI)
  Used for creating and editing panels, provides tools for creating and configuring graphic objects.
- System Management
  The System Management is the central administrative unit for WinCC OA Systems.
  - System management
  - Diagnostics
  - Reports
  - Database
  - Driver
  - Driver IEC
  - Driver OPC
  - Driver S7
  - SmartSCADA
  - Permission
    - User Administration
      The WinCC OA user administration provides important features for controlling users that use the system. Security is an important issue in the automation technology when controlling highly sensitive systems and it is of utmost importance that the users of the system have only access to the specified area of operation. With the WinCC OA user administration, you can administer users so that they can use the resources effectively without inflicting damage to the system inadvertently or otherwise
      - User administration, basics
      - User administration panel
      - Authorization levels
      - Areas
      - Groups
      - Users
      - Workstation authorization
      - Configuration Management
      - User Administration - Control Functions
        General Functions
        Windows Specific Functions
        getCurrentDomainName()
        getDomainOSUser()
        The function returns the domain, the user name, the full name, the description and the groups of the Windows user logged in.
        getOSUser()
        The function returns the user name, the full name, the OS ID, the domain and the comment of the current user.
        getOSGroupID()
        Returns the operating system ID of a specific user group.
        getOSGroupInfo()
        Returns the attributes of a domain group.
        getOSGroupName()
        Returns the group name for an OS specific ID.
        getOSGroups()
        Returns an array containing the attributes of all groups of a domain (no local groups).
        getOSGroupUsers()
        Returns all users of a group.
        getOSUserGroups()
        Returns an array containing the attributes of all groups a user is member of.
        getOSUserID()
        Returns the operating system ID of a specific user.
        getOSUserInfo()
        Returns the attributes for a user "userName".
        getOSUserName()
        Returns the user name for an OS specific ID.
        getUserPermissionForArea()
        The function getUserPermissionForArea() gets the user permission for an area.
        getWindowsEvents()
        The function returns the Windows events. The events under Windows are split into three different log types.
        setUserNameSSO()
        Sets the name of a WinCC OA user for SSO.
        usr_deleteSetting()
        Deletes a user setting from the configuration management.
        verifyOSUser()
        The function returns TRUE (in the &result parameter) if the user with the defined user name exists, the account of the user is not locked or disabled and the specified password is correct. The default user is the current operating system user.
        wss_getGenericSetting()
        Reads all workstation settings without hierarchy.
        wss_getSpecificSetting()
        Reads a specific workstation setting without hierarchy.
        wss_getSpecificWorkstationSetting()
        Reads a specific workstation setting with hierarchy.
        wss_getWorkstationSettings()
        Reads all workstation settings with hierarchy.
        Control Classes
      - Command Channel
      - Operating System Authentication
    - System Permissions
    - Authorization Check Plug-in
      The authorization check plug-in allows setting access rights on data point element level (data point values).
    - ***
  - Communication
  - Settings
- Wizard Framework
  Used for easy creation of wizards in a uniform layout style. The key elements "Navigation Bar" and "Bottom Bar" can be customized to fit the needs of the custom wizard.
- XML Panel Format
  The XML (Extensible Markup Language) panel format allows creating WinCC OA panels.
- Simple Symbols, basics
  The "Simple Symbols" functionality is used to simply assign corresponding symbols to data point types and increase the working comfort when working with different symbols.
- ScriptWizard
  Simple wizard for creating graphical user interfaces for users without prior programming knowledge.
- Panel topology/Group alert facility
  Tree structure for process panels with integrated group alert system
- Object-Oriented Panel References
  Reusable objects built with the GEDI tools. Insert them within an existing panel to provide a graphical element.
- Multilingual Projects
  WinCC OA is designed to provide both Native Language Support and Multi Language Support.
- Translator
  The WinCC OA Translator functionality supports you in creating and maintaining multilingual projects. It offers a convenient interface for translation of reusable terms.
- Layout management
  Layouts change the size and position of objects according to parameters previously defined in the GEDI.
- Generic Dialog Framework
  The Generic Dialog Framework is an easy way to generate your own dialogs by adjusting a set of prefabricated panels.
- Simple Configuration
  Simple configuration windows and panels support you in combining events (such as a mouse click) with different actions such as setting data point values, showing panels or changing attributes.
Data Management
Classify, structure and archive your data.
Business Logic / Control
Endless possibilities in data processing for your projects.
Data Visualization
User interfaces, Trends and Reports for every purpose and device.
Southbound Interfaces
The process connection to the actual machines/sensors.
Northbound Interfaces
Your portal to the cloud or supervising systems.
Web Connectivity / Network Interfaces
Data exchange, APIs and web technologies
User Management
All about authorization, authentication and login-customization.
Availability
How to get your system uptime to the maximum.
Reporting
Create state of the art project reports without limits.
Addons
Useful tools and enhancements for special demands.
Reference Tables
Detailed and extensive content for special project adaptation.
Videos & Tutorials
Explore the capabilities of WinCC OA with our carefully selected collection of video tutorials and guides.
WinCC OA Documentation
Basic information about terms and functions within the documentation.
Disclaimer
A brief clarification of liability exclusions or legal notices.

getCurrentDomainName()

The function returns the current domain of the user.

Synopsis

int getCurrentDomainName( string &domain);

Parameters


Parameter	Description
&domain	The current domain.

Return value

The function returns -1 in case of errors and otherwise 0.

Error

Missing or wrong parameters.

Description

The function returns the current domain of the user. This means the domain the user belongs to.

A computer can also be part of a domain. If a local user is logged in, the function returns the computer name instead of the domain. To query the domain name of the computer, use the function getOSDomainName().

The function returns the current domain of the user.

main()
{
  string domain;
  int i = getCurrentDomainName(domain);
  DebugN(i, domain);
}

Assignment

User administration, Waiting Control function

Availability

CTRL