Windows NT Global Groups Are Limited to 20 Character Names

ID: Q131417


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


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, 3.51, and 4.0 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 : kbnetwork kbui ntdomain kbAPI kbSDKPlatform kbNetAPI nt32ap NTSrvWkst ntui kbGrpNet
Version : winnt:3.1,3.5,3.51,4.0; :2.2,3.1
Platform : winnt
Issue type :


Last Reviewed: October 14, 1999
© 2000 Microsoft Corporation. All rights reserved. Terms of Use.