2.2.3 INET_INFO_CONFIG_INFO

  • Article

The INET_INFO_CONFIG_INFO structure stores configuration values for an Internet protocol server.<3>

This type is declared as follows:

 typedef struct _INET_INFO_CONFIG_INFO {
   DWORD FieldControl;
   DWORD dwConnectionTimeout;
   DWORD dwMaxConnections;
   [string] LPWSTR lpszAdminName;
   [string] LPWSTR lpszAdminEmail;
   [string] LPWSTR lpszServerComment;
   LPINET_LOG_CONFIGURATION lpLogConfig;
   WORD LangId;
   LCID LocalId;
   BYTE ProductId[64];
   BOOL fLogAnonymous;
   BOOL fLogNonAnonymous;
   [string] LPWSTR lpszAnonUserName;
   WCHAR szAnonPassword[257];
   DWORD dwAuthentication;
   short sPort;
   LPINET_INFO_IP_SEC_LIST DenyIPList;
   LPINET_INFO_IP_SEC_LIST GrantIPList;
   LPINET_INFO_VIRTUAL_ROOT_LIST VirtualRoots;
 } INET_INFO_CONFIG_INFO,
  *LPINET_INFO_CONFIG_INFO;

FieldControl: A 32-bit unsigned integer that specifies a bit field. This field specifies the values of the INET_INFO_CONFIG_INFO structure that contain valid data. An implementation MUST set the flag corresponding to the structure field when returning or updating configuration data. This field MUST be set to a valid combination of the following values.

Name

Value

FC_INET_INFO_CONNECTION_TIMEOUT

0x00000001

FC_INET_INFO_MAX_CONNECTIONS

0x00000002

FC_INET_INFO_LOG_CONFIG

0x00000004

FC_INET_INFO_ADMIN_NAME

0x00000008

FC_INET_INFO_SERVER_COMMENT

0x00000010

FC_INET_INFO_ADMIN_EMAIL

0x00000020

FC_INET_INFO_HOST_NAME

0x00000040

FC_INET_INFO_SERVER_SIZE

0x00000080

 FC_INET_INFO_DEF_LOGON_DOMAIN

0x00008000

 FC_INET_INFO_AUTHENTICATION

0x00010000

 FC_INET_INFO_ALLOW_ANONYMOUS

0x00020000

 FC_INET_INFO_LOG_ANONYMOUS

0x00040000

 FC_INET_INFO_LOG_NONANONYMOUS

0x00080000

 FC_INET_INFO_ANON_USER_NAME

0x00100000

 FC_INET_INFO_ANON_PASSWORD

0x00200000

 FC_INET_INFO_PORT_NUMBER

0x00400000

 FC_INET_INFO_SITE_SECURITY

0x00800000

 FC_INET_INFO_VIRTUAL_ROOTS

0x01000000

 FC_INET_INFO_SECURE_PORT_NUMBER

0x02000000

 FC_INET_INFO_SERVER_NAME

0x04000000

 FC_INET_INFO_AUTO_START

0x08000000

 FC_INET_INFO_ADDRESS_TYPE

0x10000000

 FC_INET_INFO_IP_ADDRESS

0x20000000

dwConnectionTimeout: The time limit to maintain an inactive connection specified as the number of seconds from the last request.

dwMaxConnections: The maximum number of allowed connections to the Internet protocol server.

lpszAdminName: A pointer to a null-terminated Unicode string that contains the name of the Internet protocol server administrator.

lpszAdminEmail: A pointer to a null-terminated Unicode string that contains the email address of the Internet protocol server administrator.

lpszServerComment: A pointer to a null-terminated Unicode string that contains a comment that describes the Internet protocol server instance.

lpLogConfig: A pointer to an INET_LOG_CONFIGURATION structure that specifies the configuration of the Internet protocol server log.

LangId: A WORD containing the language identifier, a standard international numerical identifier for the language in the country or region where the server is in use, as specified in [MS-LCID] section 2.1.

LocalId: A locale identifier that is a DWORD value that consists of a language identifier, such as one specified for the LangID member, combined with a sort identifier indicating location. For example, the LangID member might indicate French, where the LocalID indicates Canada. The LocalID member is given as specified in [MS-LCID] section 2.1.

ProductId: An array of 64 bytes that MAY contain a string value, which identifies the server implementation.

fLogAnonymous: A value that is set to TRUE if data transfers from anonymous users are to be logged.

fLogNonAnonymous: A value that is set to TRUE if data transfers from non-anonymous users are to be logged.

lpszAnonUserName: A pointer to a null-terminated Unicode string that contains the name requested and accepted from an anonymous user.

szAnonPassword: An array of 257 Unicode characters containing a null-terminated Unicode string that contains a password requested and accepted from an anonymous user.<4>

dwAuthentication: A value that indicates what authentication methods can be used.

sPort: A 16-bit unsigned integer that specifies the network port on which the Internet protocol server instance is running.

DenyIPList: A pointer to an INET_INFO_IP_SEC_LIST structure that contains a list of IP addresses that will be denied connections to the Internet protocol server.

GrantIPList: A pointer to an INET_INFO_IP_SEC_LIST structure that contains a list of IP addresses that will be granted connections to the Internet protocol server.

VirtualRoots: A pointer to an INET_INFO_VIRTUAL_ROOT_LIST structure that contains a list of virtual root directories for the Internet protocol server instance.