Função getprotobynumber (winsock.h)

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

Sintaxe

protoent * getprotobynumber(
  int proto
);

Parâmetros

proto

TBD

Retornar valor

Se nenhum erro ocorrer, getprotobynumber retornará um ponteiro para a estrutura protoent . Caso contrário, ele retorna um ponteiro nulo e um número de erro específico pode 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 no servidor.
WSANO_RECOVERY	Erros não detectá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 do Windows Sockets 1.1 de bloqueio está em andamento ou o provedor de serviços ainda está processando uma função de retorno de chamada.
WSAEINTR	Uma chamada do Windows Socket 1.1 de bloqueio foi cancelada por meio de WSACancelBlockingCall.

Comentários

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

O ponteiro que é 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	winsock.h (inclua Winsock2.h)
Biblioteca	Ws2_32.lib
DLL	Ws2_32.dll

Confira também

WSAAsyncGetProtoByNumber

Funções Winsock

Referência de Winsock

getprotobyname