PROTOCOL_INFO structure
The PROTOCOL_INFO structure contains information about a protocol.
Syntax
typedef struct _PROTOCOL_INFO { DWORD dwServiceFlags; INT iAddressFamily; INT iMaxSockAddr; INT iMinSockAddr; INT iSocketType; INT iProtocol; DWORD dwMessageSize; LPTSTR lpProtocol; } PROTOCOL_INFO;
Members
- dwServiceFlags
-
Type: DWORD
-
A set of bit flags that specifies the services provided by the protocol. One or more of the following bit flags may be set.
- iAddressFamily
-
Type: INT
-
Value to pass as the af parameter when the socket function is called to open a socket for the protocol. This address family value uniquely defines the structure of protocol addresses, also known as sockaddr structures, used by the protocol.
- iMaxSockAddr
-
Type: INT
-
Maximum length of a socket address supported by the protocol, in bytes.
- iMinSockAddr
-
Type: INT
-
Minimum length of a socket address supported by the protocol, in bytes.
- iSocketType
-
Type: INT
-
Value to pass as the type parameter when the socket function is called to open a socket for the protocol.
Note that if XP_PSEUDO_STREAM is set in dwServiceFlags, the application can specify SOCK_STREAM as the type parameter to socket, regardless of the value of iSocketType.
- iProtocol
-
Type: INT
-
Value to pass as the protocol parameter when the socket function is called to open a socket for the protocol.
- dwMessageSize
-
Type: DWORD
-
Maximum message size supported by the protocol, in bytes. This is the maximum size of a message that can be sent from or received by the host. For protocols that do not support message framing, the actual maximum size of a message that can be sent to a given address may be less than this value.
The following special message size values are defined.
Value Meaning - 0
The protocol is stream-oriented; the concept of message size is not relevant.
- 0xFFFFFFFF
The protocol is message-oriented, but there is no maximum message size.
- lpProtocol
-
Type: LPTSTR
-
Pointer to a zero-terminated string that supplies a name for the protocol; for example, "SPX2."
Requirements
|
Minimum supported client |
Windows 2000 Professional [desktop apps only] |
|---|---|
|
Minimum supported server |
Windows 2000 Server [desktop apps only] |
|
Header |
|
|
Unicode and ANSI names |
PROTOCOL_INFOW (Unicode) and PROTOCOL_INFOA (ANSI) |
See also