PROTOCOL_INFO

9/8/2008

Essa estrutura contém informações sobre um protocolo.

Syntax

typedef struct _PROTOCOL_INFO { 
  DWORD dwServiceFlags; 
  INT iAddressFamily; 
  INT iMaxSockAddr; 
  INT iMinSockAddr; 
  INT iSocketType; 
  INT iProtocol; 
  DWORD dwMessageSize; 
  LPTSTR lpProtocol;
} PROTOCOL_INFO; 

Os membros

• dwServiceFlags
  Um conjunto de sinalizadores bit que especifica os serviços fornecidos pelo protocolo. A seguinte tabela mostra os sinalizadores bit você pode definir.

  Valor	Descrição
  XP_CONNECTIONLESS	Se este sinalizador estiver definido, o protocolo fornece serviço sem conexão (datagrama). Se este sinalizador é Clear, o protocolo fornece transferência de dados Connection-Oriented.
  XP_GUARANTEED_DELIVERY	Se este sinalizador estiver definido, o protocolo garante que todos os dados enviados alcançarão o destino pretendido. Se este sinalizador é Clear, não há nenhum tal garantia.
  XP_GUARANTEED_ORDER	Se este sinalizador estiver definido, o protocolo garante que dados chegarão na ordem na qual ela foi enviada. Observe que esta característica não garante entrega dos dados, Somente sua ordem. Se este sinalizador é Clear, a ordem dos dados enviados não é garantida.
  XP_MESSAGE_ORIENTED	Se este sinalizador for definido, o protocolo será orientado a mensagem. Um protocolo message-oriented honra limites mensagem. Se este sinalizador é Clear, o protocolo é transmitir orientado, e a concepção de limites mensagem é irrelevante.
  XP_PSEUDO_STREAM	Se este sinalizador for definido, o protocolo será um protocolo message-oriented que ignora mensagem limites para todas as operações Receber. Este opcional funcionalidade é útil quando você não desejar o protocolo para mensagens quadro. Um aplicativo que exige características Stream-Oriented pode aberto um Soquete com tipo SOCK_STREAM para transporte protocolos que suporte essa funcionalidade, regardless of o valor de iSocketType.
  XP_GRACEFUL_CLOSE	Se este sinalizador estiver definido, o protocolo oferece suporte a duas fases fechar operações, fechar also Known as normal operações. Se este sinalizador é Clear, o protocolo oferece suporte somente fechar abortive operações.
  XP_EXPEDITED_DATA	Se este sinalizador estiver definido, a oferece suporte a protocolo emitidos dados, dados urgentes also Known as.
  XP_CONNECT_DATA	Se este sinalizador estiver definido, o protocolo oferece suporte a dados conectar.
  XP_DISCONNECT_DATA	Se este sinalizador estiver definido, a protocolo oferece suporte a desconectar dados.
  XP_SUPPORTS_BROADCAST	Se este sinalizador estiver definido, o protocolo oferece suporte a um transmitir mecanismo.
  XP_SUPPORTS_MULTICAST	Se este sinalizador estiver definido, o protocolo oferece suporte a um Multicast mecanismo.
  XP_BANDWIDTH_ALLOCATION	Se este sinalizador estiver definido, o protocolo oferece suporte a um mecanismo para alocar uma largura de banda garantida para um aplicativo.
  XP_FRAGMENTATION	Se este sinalizador estiver definido, o protocolo oferece suporte a fragmentação mensagem; físico rede MTU está oculta a partir de aplicativos.
  XP_ENCRYPTS	Se este sinalizador estiver definido, o protocolo oferece suporte a criptografia de dados.

• iAddressFamily
  O valor para transmitir como o AF parâmetro quando o Soquete (Soquetes do Windows) função é chamado para aberto um Soquete para o protocolo. Este valor família de endereços exclusivamente define a estrutura de endereços protocolo, também conhecido como sockaddr estruturas, usadas pelo protocolo.

• iMaxSockAddr
  Comprimento Máximo de um endereço Soquete com suporte, o protocolo.

• iMinSockAddr
  O comprimento mínimo de um endereço Soquete com suporte, o protocolo.

• iSocketType
  O valor para transmitir como o tipo parâmetro quando o Soquete (Soquetes do Windows) função é chamado para aberto um Soquete para o protocolo.

  Observação

  Se XP_PSEUDO_STREAM for definida no dwServiceFlags, o aplicativo pode especificar SOCK_STREAM como o tipo parâmetro para Soquete, regardless of o valor de iSocketType.

• iProtocol
  O valor para transmitir como o protocolo parâmetro quando o Soquete (Soquetes do Windows) função é chamado para aberto um Soquete para o protocolo.

• dwMessageSize
  Tamanho máximo de mensagem com suporte, o protocolo. Este é o tamanho máximo de uma mensagem que pode ser enviada de ou recebida pela hospedar. Para protocolos que não suporte mensagem estruturas, o real tamanho máximo de uma mensagem que pode ser enviada para um determinado endereço pode ser menor que esse valor.

  A seguinte tabela mostra os valores tamanho mensagem especiais que são definidos.

  Valor	Descrição
  0	O protocolo é fluxo-orientados; a concepção do tamanho mensagem não é relevante.
  0xFFFFFFFF	O protocolo é orientado a mensagem, mas não há nenhum tamanho máximo de mensagem.

• lpProtocol
  Aponta para uma que forneça um nome para o protocolo, de exemplo, SPX2 seqüência de caracteres zero-Terminated.

Requirements

See Also

Reference

socket (Windows Sockets)