Microsoft KB Archive/99165

= Explanation of the num_logons Variable =

Article ID: 99165

Article Last Modified on 10/31/2006



This article was previously published under Q99165



SUMMARY
NetWkstaSetUID2, NetUserGetInfo, and NetUserValidate2 reference the variable usrlog1_num_logons. This article explains the meaning supplied for the value of this variable and what conditions cause the value to be reset.

Page 669 of the &quot;Microsoft LAN Manager Programmer's Reference&quot; states that this value is for the &quot;number of times this user user is logged on.&quot; A clearer statement is: [num_logons is a cumulative historical record of logons ]

num_lo

Specifies the total number of times this user has logged on. A value of -1 means the number of logons is UNKNOWN or that the user's account is set to logon to &quot;any server&quot;.



MORE INFORMATION
As stated above, the &quot;number of times this user is logged on&quot; is not the number of concurrent logons but the number of cumulative logons for a given user.

The user option shown in /Net Admin/Accounts/Users/Zoom/Paths must be set for a specific server to handle logon requests:

Domain controller

Any Server

(*) Servername [.....................] <-Set to specific servername

The usrlog1_num_logons value is changed to zero if the user preference noted above is changed (for example, to Domain controller, Any Server, and so on).

The value is zero when the user account is created, and it is incremented for each logon to a specified &quot;named&quot; server. Otherwise, the value remains -1 (UNKNOWN)--the &quot;Any Server&quot; options do not allow a consistent updating of the num_logons variable.

Additional query words: 2.10 2.1 2.10a 2.1a 2.20 2.2

Keywords: KB99165

-

[mailto:TECHNET@MICROSOFT.COM Send feedback to Microsoft]

© Microsoft Corporation. All rights reserved.