estrutura WSAPROTOCOL_INFOA (winsock2.h)

A estrutura WSAPROTOCOL_INFO é usada para armazenar ou recuperar informações completas para um determinado protocolo.

Sintaxe

typedef struct _WSAPROTOCOL_INFOA {
  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;
  CHAR             szProtocol[WSAPROTOCOL_LEN + 1];
} WSAPROTOCOL_INFOA, *LPWSAPROTOCOL_INFOA;

Membros

dwServiceFlags1

Tipo: DWORD

Uma máscara de bits que descreve os serviços fornecidos pelo protocolo. Os valores possíveis para esse membro são definidos no arquivo de cabeçalho Winsock2.h .

Os valores a seguir são possíveis.

dwServiceFlags2

Tipo: DWORD

Reservado para definições adicionais de atributo de protocolo.

dwServiceFlags3

Tipo: DWORD

Reservado para definições adicionais de atributo de protocolo.

dwServiceFlags4

Tipo: DWORD

Reservado para definições adicionais de atributo de protocolo.

dwProviderFlags

Tipo: DWORD

Um conjunto de sinalizadores que fornece informações sobre como esse protocolo é representado no catálogo do Winsock. Os valores possíveis para esse membro são definidos no arquivo de cabeçalho Winsock2.h .

Os valores de sinalizador a seguir são possíveis.

ProviderId

Tipo: GUID

Um GUID (identificador global exclusivo) atribuído ao provedor pelo fornecedor do provedor de serviços. Esse valor é útil para instâncias em que mais de um provedor de serviços é capaz de implementar um protocolo específico. Um aplicativo pode usar o membro ProviderId para distinguir entre provedores que, de outra forma, podem ser indistinguíveis.

dwCatalogEntryId

Tipo: DWORD

Um identificador exclusivo atribuído pelo WS2_32.DLL para cada estrutura WSAPROTOCOL_INFO .

ProtocolChain

Tipo: WSAPROTOCOLCHAIN

A estrutura WSAPROTOCOLCHAIN associada ao protocolo. Se o comprimento da cadeia for 0, essa entrada WSAPROTOCOL_INFO representará um protocolo em camadas que tem o SPI do Windows Sockets 2 como bordas superior e inferior. Se o comprimento da cadeia for igual a 1, essa entrada representará um protocolo base cujo identificador de Entrada de Catálogo está no membro dwCatalogEntryId da estrutura WSAPROTOCOL_INFO . Se o comprimento da cadeia for maior que 1, essa entrada representará uma cadeia de protocolo que consiste em um ou mais protocolos em camadas sobre um protocolo base. Os identificadores de Entrada de Catálogo correspondentes estão na matriz ProtocolChain.ChainEntries começando com o protocolo em camadas na parte superior (o elemento zero na matriz ProtocolChain.ChainEntries) e terminando com o protocolo base. Consulte a especificação interface do provedor de serviços do Windows Sockets 2 para obter mais informações sobre cadeias de protocolo.

iVersion

Tipo: int

O identificador de versão do protocolo.

iAddressFamily

Tipo: int

Um valor a ser passado como o parâmetro da família de endereços para a função soquete ou WSASocket para abrir um soquete para esse protocolo. Esse valor também define exclusivamente a estrutura de um endereço de protocolo para um sockaddr usado pelo protocolo.

Na SDK do Windows lançada para Windows Vista e posterior, os valores possíveis para a família de endereços são definidos no arquivo de cabeçalho Ws2def.h. Observe que o arquivo de cabeçalho Ws2def.h é incluído automaticamente no Winsock2.h e nunca deve ser usado diretamente.

Em versões do SDK da Plataforma para Windows Server 2003 e anteriores, os valores possíveis para a família de endereços são definidos no arquivo de cabeçalho Winsock2.h .

Os valores com suporte no momento são AF_INET ou AF_INET6, que são os formatos de família de endereços da Internet para IPv4 e IPv6. Outras opções para família de endereços (AF_NETBIOS para uso com NetBIOS, por exemplo) têm suporte se um provedor de serviços do Windows Sockets para a família de endereços estiver instalado. Observe que os valores para a família de endereços AF_ e PF_ constantes da família de protocolos são idênticos (por exemplo, AF_INET e PF_INET), portanto, qualquer constante pode ser usada.

A tabela a seguir lista valores comuns para a família de endereços, embora muitos outros valores sejam possíveis.

iMaxSockAddr

Tipo: int

O comprimento máximo do endereço, em bytes.

iMinSockAddr

Tipo: int

O comprimento mínimo do endereço, em bytes.

iSocketType

Tipo: int

Um valor a ser passado como o parâmetro de tipo de soquete para a função socket ou WSASocket para abrir um soquete para esse protocolo. Os valores possíveis para o tipo de soquete são definidos no arquivo de cabeçalho Winsock2.h .

A tabela a seguir lista os valores possíveis para o membro iSocketType com suporte para Windows Sockets 2:

iProtocol

Tipo: int

Um valor a ser passado como o parâmetro de protocolo para a função soquete ou WSASocket para abrir um soquete para esse protocolo. As opções possíveis para o membro iProtocol são específicas para a família de endereços e o tipo de soquete especificados.

No SDK do Windows lançado para Windows Vista e posterior, esse membro pode ser um dos valores do tipo de enumeração IPPROTO definido no arquivo de cabeçalho Ws2def.h. Observe que o arquivo de cabeçalho Ws2def.h é incluído automaticamente em Winsock2.h e nunca deve ser usado diretamente.

Em versões do SDK da Plataforma para Windows Server 2003 e anteriores, os valores possíveis para o membro iProtocol são definidos nos arquivos de cabeçalho Winsock2.h e Wsrm.h .

A tabela a seguir lista valores comuns para o iProtocol , embora muitos outros valores sejam possíveis.

iProtocolMaxOffset

Tipo: int

O valor máximo que pode ser adicionado ao iProtocol ao fornecer um valor para o parâmetro de protocolo para a função soquete ou WSASocket . Nem todos os protocolos permitem um intervalo de valores. Quando esse é o caso , iProtocolMaxOffset é zero.

iNetworkByteOrder

Tipo: int

Atualmente, esses valores são constantes de manifesto (BIGENDIAN e LITTLEENDIAN) que indicam big-endian ou little-endian com os valores 0 e 1, respectivamente.

iSecurityScheme

Tipo: int

O tipo de esquema de segurança empregado (se houver). Um valor de SECURITY_PROTOCOL_NONE (0) é usado para protocolos que não incorporam provisionamentos de segurança.

dwMessageSize

Tipo: DWORD

O tamanho máximo da mensagem, em bytes, compatível com o protocolo. Esse é o tamanho máximo que pode ser enviado de qualquer uma das interfaces locais do host. Para protocolos que não dão suporte ao enquadramento de mensagens, o máximo real que pode ser enviado para um determinado endereço pode ser menor. Não há nenhuma provisão padrão para determinar o tamanho máximo da mensagem de entrada. Os valores especiais a seguir são definidos.

dwProviderReserved

Tipo: DWORD

Reservado para uso por provedores de serviços.

szProtocol[WSAPROTOCOL_LEN + 1]

Tipo: TCHAR[WSAPROTOCOL_LEN+1]

Uma matriz de caracteres que contém um nome legível para humanos que identifica o protocolo, por exemplo, "MSAFD Tcpip [UDP/IP]". O número máximo de caracteres permitido é WSAPROTOCOL_LEN, que é definido como 255.

Comentários

Requisitos

Confira também

Wsaenumprotocols

WSAPROTOCOLCHAIN

WSAPROTOCOL_INFOW

WSASend

WSASendTo

Wsasocket

WSCInstallProvider

WSCInstallProvider64_32

WSCUpdateProvider

WSCUpdateProvider32

Getsockopt

socket