estructura WSAPROTOCOL_INFOW (winsock2.h)

La estructura WSAPROTOCOL_INFOW se usa para almacenar o recuperar información completa de un protocolo determinado. El nombre del protocolo se representa como una matriz de caracteres Unicode.

Sintaxis

typedef struct _WSAPROTOCOL_INFOW {
  DWORD            dwServiceFlags1;
  DWORD            dwServiceFlags2;
  DWORD            dwServiceFlags3;
  DWORD            dwServiceFlags4;
  DWORD            dwProviderFlags;
  GUID             ProviderId;
  DWORD            dwCatalogEntryId;
  WSAPROTOCOLCHAIN ProtocolChain;
  int              iVersion;
  int              iAddressFamily;
  int              iMaxSockAddr;
  int              iMinSockAddr;
  int              iSocketType;
  int              iProtocol;
  int              iProtocolMaxOffset;
  int              iNetworkByteOrder;
  int              iSecurityScheme;
  DWORD            dwMessageSize;
  DWORD            dwProviderReserved;
  WCHAR            szProtocol[WSAPROTOCOL_LEN + 1];
} WSAPROTOCOL_INFOW, *LPWSAPROTOCOL_INFOW;

Miembros

dwServiceFlags1

Tipo: DWORD

Máscara de bits que describe los servicios proporcionados por el protocolo. Los valores posibles para este miembro se definen en el archivo de encabezado Winsock2.h .

Los siguientes valores son posibles.

dwServiceFlags2

Tipo: DWORD

Reservado para definiciones adicionales de atributo de protocolo.

dwServiceFlags3

Tipo: DWORD

Reservado para definiciones adicionales de atributo de protocolo.

dwServiceFlags4

Tipo: DWORD

Reservado para definiciones adicionales de atributo de protocolo.

dwProviderFlags

Tipo: DWORD

Conjunto de marcas que proporciona información sobre cómo se representa este protocolo en el catálogo winsock. Los valores posibles para este miembro se definen en el archivo de encabezado Winsock2.h .

Los siguientes valores son posibles.

ProviderId

Tipo: GUID

Identificador único global (GUID) asignado al proveedor por el proveedor de servicios. Este valor es útil para instancias en las que más de un proveedor de servicios puede implementar un protocolo determinado. Una aplicación puede usar el miembro ProviderId para distinguir entre proveedores que, de lo contrario, podrían ser indistinguibles.

dwCatalogEntryId

Tipo: DWORD

Identificador único asignado por el WS2_32.DLL para cada estructura de WSAPROTOCOL_INFO .

ProtocolChain

Tipo: WSAPROTOCOLCHAIN

Estructura WSAPROTOCOLCHAIN asociada al protocolo. Si la longitud de la cadena es 0, esta entrada de WSAPROTOCOL_INFO representa un protocolo en capas que tiene SPI de Windows Sockets 2 como sus bordes superior e inferior. Si la longitud de la cadena es igual a 1, esta entrada representa un protocolo base cuyo identificador de entrada de catálogo está en el miembro dwCatalogEntryId de la estructura WSAPROTOCOL_INFO . Si la longitud de la cadena es mayor que 1, esta entrada representa una cadena de protocolos que consta de uno o varios protocolos en capas sobre un protocolo base. Los identificadores de entrada de catálogo correspondientes están en la matriz ProtocolChain.ChainEntries empezando por el protocolo en capas en la parte superior (el elemento cero de la matriz ProtocolChain.ChainEntries) y finalizando con el protocolo base. Consulte la especificación de interfaz del proveedor de servicios de Windows Sockets 2 para obtener más información sobre las cadenas de protocolo.

iVersion

Tipo: int

Identificador de versión del protocolo.

iAddressFamily

Tipo: int

Valor que se va a pasar como parámetro de familia de direcciones a la función socket o WSASocket para abrir un socket para este protocolo. Este valor también define de forma única la estructura de una dirección de protocolo para un sockaddr usado por el protocolo.

En windows SDK publicado para Windows Vista y versiones posteriores, los valores posibles para la familia de direcciones se definen en el archivo de encabezado Ws2def.h . Tenga en cuenta que el archivo de encabezado Ws2def.h se incluye automáticamente en Winsock2.h y nunca se debe usar directamente.

En las versiones del SDK de plataforma para Windows Server 2003 y versiones anteriores, los valores posibles para la familia de direcciones se definen en el archivo de encabezado Winsock2.h .

Los valores admitidos actualmente son AF_INET o AF_INET6, que son los formatos de familia de direcciones de Internet para IPv4 e IPv6. Se admiten otras opciones para la familia de direcciones (AF_NETBIOS para su uso con NetBIOS, por ejemplo) si se instala un proveedor de servicios de Windows Sockets para la familia de direcciones. Tenga en cuenta que los valores de la familia de direcciones AF_ y las constantes de familia de protocolos PF_ son idénticas (por ejemplo, AF_INET y PF_INET), por lo que se puede usar cualquiera de las constantes.

En la tabla siguiente se enumeran los valores comunes de la familia de direcciones, aunque muchos otros valores son posibles.

iMaxSockAddr

Tipo: int

Longitud máxima de la dirección, en bytes.

iMinSockAddr

Tipo: int

Longitud mínima de la dirección, en bytes.

iSocketType

Tipo: int

Valor que se va a pasar como parámetro de tipo de socket a la función socket o WSASocket para abrir un socket para este protocolo. Los valores posibles para el tipo de socket se definen en el archivo de encabezado Winsock2.h .

En la tabla siguiente se enumeran los valores posibles para el miembro iSocketType admitido para Windows Sockets 2:

iProtocol

Tipo: int

Valor que se va a pasar como parámetro de protocolo a la función socket o WSASocket para abrir un socket para este protocolo. Las opciones posibles para el miembro iProtocol son específicas de la familia de direcciones y el tipo de socket especificado.

En Windows SDK publicado para Windows Vista y versiones posteriores, este miembro puede ser uno de los valores del tipo de enumeración IPPROTO definido en el archivo de encabezado Ws2def.h . Tenga en cuenta que el archivo de encabezado Ws2def.h se incluye automáticamente en Winsock2.h y nunca se debe usar directamente.

En las versiones del SDK de plataforma para Windows Server 2003 y versiones anteriores, los valores posibles para el miembro iProtocol se definen en los archivos de encabezado Winsock2.h y Wsrm.h .

En la tabla siguiente se enumeran los valores comunes para iProtocol , aunque muchos otros valores son posibles.

iProtocolMaxOffset

Tipo: int

Valor máximo que se puede agregar al miembro iProtocol al proporcionar un valor para el parámetro de protocolo para socket y WSASocket. No todos los protocolos permiten un intervalo de valores. Cuando este es el caso iProtocolMaxOffset es cero.

iNetworkByteOrder

Tipo: int

Actualmente, estos valores son constantes de manifiesto (BIGENDIAN y LITTLEENDIAN) que indican big-endian o little-endian con los valores 0 y 1 respectivamente.

iSecurityScheme

Tipo: int

Tipo de esquema de seguridad empleado (si existe). Se usa un valor de SECURITY_PROTOCOL_NONE (0) para protocolos que no incorporan disposiciones de seguridad.

dwMessageSize

Tipo: DWORD

Tamaño máximo del mensaje, en bytes, admitido por el protocolo. Este es el tamaño máximo que se puede enviar desde cualquiera de las interfaces locales del host. En el caso de los protocolos que no admiten tramas de mensajes, el máximo real que se puede enviar a una dirección determinada puede ser menor. No hay ningún aprovisionamiento estándar para determinar el tamaño máximo del mensaje entrante. Se definen los siguientes valores especiales.

dwProviderReserved

Tipo: DWORD

Reservado para su uso por parte de los proveedores de servicios.

szProtocol[WSAPROTOCOL_LEN + 1]

Tipo: WCHAR[WSAPROTOCOL_LEN+1]

Matriz de caracteres Unicode que contiene un nombre legible que identifica el protocolo, por ejemplo, "MSAFD Tcpip [UDP/IP]". El número máximo de caracteres permitido es WSAPROTOCOL_LEN, que se define como 255.

Comentarios

Requisitos

Consulte también

WSAPROTOCOLCHAIN

WSAPROTOCOL_INFO

WSASend

WSASendTo

WSASocket

WSCEnumProtocols

WSCEnumProtocols32

getsockopt

socket