Função getprotobyname (winsock.h)

A função getprotobyname recupera as informações de protocolo correspondentes a um nome de protocolo.

Sintaxe

protoent * getprotobyname(
  [in] const char *name
);

Parâmetros

[in] name

Ponteiro para um nome de protocolo terminado em nulo.

Retornar valor

Se nenhum erro ocorrer, getprotobyname retornará um ponteiro para o 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.
WSAEFAULT	O parâmetro name não é uma parte válida do espaço de endereço do usuário.
WSAEINTR	Uma chamada de bloqueio do Windows Socket 1.1 foi cancelada por meio de WSACancelBlockingCall.

Comentários

A função getprotobyname retorna um ponteiro para a estrutura protoente que contém os nomes e o número do protocolo que correspondem ao protocolo especificado no parâmetro name . Todas as cadeias de caracteres são terminadas em nulo. A estrutura protoente é alocada pela biblioteca do Windows Sockets. Um aplicativo nunca deve tentar modificar essa estrutura ou liberar nenhum de seus componentes. Além disso, como o hostent, apenas uma cópia dessa estrutura é alocada por thread, portanto, o aplicativo deve copiar todas as informações necessárias antes de emitir qualquer outra chamada 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

WSAAsyncGetProtoByName

Funções Winsock

Referência de Winsock

getprotobynumber