Share via

2.2.1.2.50 DHCP_MIB_INFO_VQ

  • Article

The DHCP_MIB_INFO_VQ structure contains the counter values for the DHCP server. This structure is an extension of the DHCP_MIB_INFO (section 2.2.1.2.48) structure. This structure is used by an RPC method like R_DhcpGetMibInfoVQ (section 3.1.4.44) to return DHCP server statistics. 

 typedef struct _DHCP_MIB_INFO_VQ {
   DWORD Discovers;
   DWORD Offers;
   DWORD Requests;
   DWORD Acks;
   DWORD Naks;
   DWORD Declines;
   DWORD Releases;
   DATE_TIME ServerStartTime;
   DWORD QtnNumLeases;
   DWORD QtnPctQtnLeases;
   DWORD QtnProbationLeases;
   DWORD QtnNonQtnLeases;
   DWORD QtnExemptLeases;
   DWORD QtnCapableClients;
   DWORD QtnIASErrors;
   DWORD Scopes;
   [size_is(Scopes)] LPSCOPE_MIB_INFO_VQ ScopeInfo;
 } DHCP_MIB_INFO_VQ,
  *LPDHCP_MIB_INFO_VQ;

Discovers: This is of type DWORD, containing the number of DHCPDISCOVER messages [RFC2131] received by the DHCPv4 server from the DHCPv4 clients since the DHCP server was last started. This is used for statistical analysis by the DHCPv4 server.

Offers: This is of type DWORD, containing the number of DHCPOFFER messages sent by the DHCPv4 server to the DHCPv4 client that the DHCPv4 client has not confirmed since the DHCP server was last started. This is used for statistical analysis by the DHCPv4 server.

Requests: This is of type DWORD, containing the number of DHCPREQUEST messages received by the DHCPv4 server from the DHCPv4 clients since the DHCP server was last started. This is used for statistical analysis by the DHCPv4 server.

Acks: This is of type DWORD, containing the number of DHCPACK messages sent by the DHCPv4 server to the DHCPv4 client since the DHCP server was last started. This is used for statistical analysis by the DHCPv4 server.

Naks: This is of type DWORD, containing the number of DHCPNAK messages sent by the DHCPv4 server to DHCPv4 clients since the DHCP server was last started. This is used for statistical analysis by the DHCPv4 server.

Declines: This is of type DWORD, containing the number of DHCPDECLINE messages received by the DHCPv4 server from DHCPv4 clients since the DHCP server was last started. This is used for statistical analysis by the DHCPv4 server.

Releases: This is of type DWORD, containing the number of DHCPRELEASE messages received by the DHCPv4 server from DHCP clients since the DHCP server was last started. This is used for statistical analysis by the DHCPv4 server.

ServerStartTime: This is of type DATE_TIME (section 2.2.1.2.11), containing the start time of the DHCPv4 server.

QtnNumLeases: This is an unused field; it MUST be initialized to zero in an RPC method that modifies the DHCPv4 server configuration and treated as an error if it is nonzero in an RPC method that queries DHCPv4 server configuration.

QtnPctQtnLeases: This is an unused field; it MUST be initialized to zero in an RPC method that modifies the DHCPv4 server configuration and treated as an error if it is nonzero in an RPC method that queries DHCPv4 server configuration.

QtnProbationLeases: This is an unused field; it MUST be initialized to zero in an RPC method that modifies the DHCPv4 server configuration and treated as an error if nonzero in an RPC method that queries DHCPv4 server configuration.

QtnNonQtnLeases: This is an unused field; it MUST be initialized to zero in an RPC method that modifies the DHCPv4 server configuration and treated as an error if it is nonzero in an RPC method that queries DHCPv4 server configuration.

QtnExemptLeases: This is an unused field; it MUST be initialized to zero in an RPC method that modifies the DHCPv4 server configuration and treated as an error if it is nonzero in an RPC method that queries DHCPv4 server configuration.

QtnCapableClients: This is an unused field; it MUST be initialized to zero in an RPC method that modifies the DHCPv4 server configuration and treated as an error if nonzero in an RPC method that queries DHCPv4 server configuration.

QtnIASErrors: This is an unused field; it MUST be initialized to zero in an RPC method that modifies the DHCPv4 server configuration and treated as an error if nonzero in an RPC method that queries DHCPv4 server configuration.

Scopes: This is of type DWORD, containing the number of DHCPv4 scopes configured on the current DHCPv4 server. This is used for statistical analysis by the DHCPv4 server. This field defines the number of DHCPv4 scopes in the subsequent field ScopeInfo.

ScopeInfo: This is a pointer to an array SCOPE_MIB_INFO_VQ (section 2.2.1.2.49) of length Scopes that contains the information about the IPv4 scopes configured on DHCPv4 server.