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 |
|---|---|
| Uma chamada WSAStartup bem-sucedida deve ocorrer antes de usar essa função. | |
| O subsistema de rede falhou. | |
| Protocolo de resposta autoritativa não encontrado. | |
| Um Protocolo não autenticativo não encontrado ou uma falha de servidor. | |
| Erros não recuperáveis, o banco de dados de protocolos não está acessível. | |
| Nome válido, nenhum registro de dados do tipo solicitado. | |
| 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. | |
| 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 |