Função getprotobynumber (winsock2.h)

A função getprotobynumber recupera informações de protocolo correspondentes a um número de protocolo.

Sintaxe

protoent *WSAAPI getprotobynumber(
  [in] int number
);

Parâmetros

[in] number

Número do protocolo, na ordem de bytes do host.

Retornar valor

Se nenhum erro ocorrer, getprotobynumber retornará um ponteiro para a estrutura protoente . Caso contrário, ele retornará um ponteiro nulo e um número de erro específico poderá ser recuperado chamando WSAGetLastError.

Código do erro	Significado
WSANOTINITIALISED	Uma chamada WSAStartup bem-sucedida deve ocorrer antes de usar essa função.
WSAENETDOWN	O subsistema de rede falhou.
WSAHOST_NOT_FOUND	Protocolo de resposta autoritativa não encontrado.
WSATRY_AGAIN	Um Protocolo não autenticativo não encontrado ou uma falha de servidor.
WSANO_RECOVERY	Erros não recuperáveis, o banco de dados de protocolos não está acessível.
WSANO_DATA	Nome válido, nenhum registro de dados do tipo solicitado.
WSAEINPROGRESS	Uma chamada de bloqueio do Windows Sockets 1.1 está em andamento ou o provedor de serviços ainda está processando uma função de retorno de chamada.
WSAEINTR	Uma chamada de bloqueio do Windows Socket 1.1 foi cancelada por meio de WSACancelBlockingCall.

Comentários

Essa função getprotobynumber retorna um ponteiro para a estrutura protoente , conforme descrito anteriormente em getprotobyname. O conteúdo da estrutura corresponde ao número de protocolo especificado.

O ponteiro retornado aponta para a estrutura alocada pelo Windows Sockets. O aplicativo nunca deve tentar modificar essa estrutura ou liberar nenhum de seus componentes. Além disso, apenas uma cópia dessa estrutura é alocada por thread, portanto, o aplicativo deve copiar todas as informações necessárias antes de emitir quaisquer outras chamadas de função do Windows Sockets.

Windows Phone 8: essa função tem suporte para aplicativos da Windows Phone Store no Windows Phone 8 e posterior.

Windows 8.1 e Windows Server 2012 R2: essa função tem suporte para aplicativos da Windows Store em Windows 8.1, Windows Server 2012 R2 e posteriores.

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Windows 8.1, Windows Vista [aplicativos da área de trabalho | Aplicativos UWP]
Servidor mínimo com suporte	Windows Server 2003 [aplicativos da área de trabalho | Aplicativos UWP]
Plataforma de Destino	Windows
Cabeçalho	winsock2.h (inclua Winsock2.h)
Biblioteca	Ws2_32.lib
DLL	Ws2_32.dll

Confira também

WSAAsyncGetProtoByNumber

Funções Winsock

Referência de Winsock

getprotobyname