2.2.3 INET_INFO_CONFIG_INFO
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.