Windows NT Global Groups are Limited to 20 Character Names

 Last reviewed: March 25, 1997
Article ID: Q131417

The information in this article applies to:
  • Microsoft Windows NT operating system version 3.1
  • Microsoft Windows NT Advanced Server version 3.1
  • Microsoft Windows NT Workstation version 3.5, and 3.51
  • Microsoft Windows NT Server version 3.5, and 3.51
  • Microsoft LAN Manager version 2.2
  • Microsoft Windows NT Workstation version 4.0
  • Microsoft Windows NT Server version 4.0

SYMPTOMS

Custom applications that creates Windows NT Global Groups with names longer than 20 characters appear to work correctly. However, when you attempt to view, modify, or delete these global groups with User Manager for Domains, the following message appears: 

   The following error occurred accessing the properties of the group
   <Large Group Name>:

   The filename, directory name, or volume label syntax is incorrect.

   The group properties cannot be edited or viewed at this time.

CAUSE

Windows NT 3.1, 3.5, and 3.51 do not support Windows NT global groups with names longer than 20 characters. This limit is imposed to allow for interoperability with OS/2 LAN Manager, DOS LAN Manager, IBM LAN Server, and Windows for Workgroups.

RESOLUTION

Limit the length of global group names to 20 characters (as defined by the constant LM20_GNLEN in LMCONS.H). Local groups are not limited to 20 characters so they may be used where large group names are required.

The following functions should use global group names that are no greater than LM20_GNLEN bytes in length. 

   NetGroupAdd
   NetGroupAddUser
   NetGroupEnum
   NetGroupGetInfo
   NetGroupSetInfo
   NetGroupDel
   NetGroupDelUser
   NetGroupGetUsers
   NetGroupSetUsers
   NetUserSetGroups
There is no function to rename a global group name.

Other APIs that manipulate global groups should not be used with global groups that have names exceeding 20 characters as the results are unpredictable.

Additional query words: prodnt
Keywords : kbui nt32ap ntdomain NTSrvWkst ntui
Version : 3.1 3.5 3.51| 2.20 4.0
Platform : OS/2 WINDOWS

THE INFORMATION PROVIDED IN THE MICROSOFT KNOWLEDGE BASE IS PROVIDED "AS IS" WITHOUT WARRANTY OF ANY KIND. MICROSOFT DISCLAIMS ALL WARRANTIES, EITHER EXPRESS OR IMPLIED, INCLUDING THE WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE. IN NO EVENT SHALL MICROSOFT CORPORATION OR ITS SUPPLIERS BE LIABLE FOR ANY DAMAGES WHATSOEVER INCLUDING DIRECT, INDIRECT, INCIDENTAL, CONSEQUENTIAL, LOSS OF BUSINESS PROFITS OR SPECIAL DAMAGES, EVEN IF MICROSOFT CORPORATION OR ITS SUPPLIERS HAVE BEEN ADVISED OF THE POSSIBILITY OF SUCH DAMAGES. SOME STATES DO NOT ALLOW THE EXCLUSION OR LIMITATION OF LIABILITY FOR CONSEQUENTIAL OR INCIDENTAL DAMAGES SO THE FOREGOING LIMITATION MAY NOT APPLY.

Last reviewed: March 25, 1997
© 1998 Microsoft Corporation. All rights reserved. Terms of Use.