3.5.4.9.3 NetrLogonControl (Opnum 12)

The NetrLogonControl method is a predecessor to the NetrLogonControl2Ex method (section 3.5.4.9.1). All parameters of this method SHOULD<262> have the same meanings as the identically named parameters of the NetrLogonControl2Ex method.

 NET_API_STATUS NetrLogonControl(
   [in, unique, string] LOGONSRV_HANDLE ServerName,
   [in] DWORD FunctionCode,
   [in] DWORD QueryLevel,
   [out, switch_is(QueryLevel)] PNETLOGON_CONTROL_QUERY_INFORMATION Buffer
 );

All restrictions on parameter values in the NetrLogonControl2Ex method (section 3.5.4.9.1) apply. Extra restrictions are applied to the values of the FunctionCode<263> and QueryLevel parameters as follows:

  • The value of QueryLevel parameter is restricted to 0x00000001. If 0x00000002 is used, the error ERROR_NOT_SUPPORTED is returned; if any value larger than 0x00000002 is used, the error ERROR_INVALID_LEVEL is returned.

Message processing is identical to NetrLogonControl2Ex (section 3.5.4.9.1), except for the following:

  • The Data parameter of NetrLogonControl2Ex is set to NULL.