Función getprotobyname (winsock.h)
La función getprotobyname recupera la información del protocolo correspondiente a un nombre de protocolo.
Sintaxis
protoent * getprotobyname(
[in] const char *name
);
Parámetros
[in] name
Puntero a un nombre de protocolo terminado en null.
Valor devuelto
Si no se produce ningún error, getprotobyname devuelve un puntero al protoent. De lo contrario, devuelve un puntero nulo y se puede recuperar un número de error específico llamando a WSAGetLastError.
| Código de error | Significado |
|---|---|
| Debe producirse una llamada WSAStartup correcta antes de usar esta función. | |
| Error en el subsistema de red. | |
| No se encontró el protocolo de respuesta autoritativa. | |
| No se encontró un protocolo no autenticado o un error en el servidor. | |
| Errores irrecuperables, la base de datos de protocolos no es accesible. | |
| Nombre válido, sin registro de datos del tipo solicitado. | |
| Una llamada de Bloqueo de Windows Sockets 1.1 está en curso o el proveedor de servicios sigue procesando una función de devolución de llamada. | |
| El parámetro name no es una parte válida del espacio de direcciones del usuario. | |
| Se canceló una llamada de Bloqueo de Windows Socket 1.1 a través de WSACancelBlockingCall. |
Comentarios
La función getprotobyname devuelve un puntero a la estructura protoent que contiene los nombres y el número de protocolo que corresponden al protocolo especificado en el parámetro name . Todas las cadenas terminan en null. La biblioteca de Windows Sockets asigna la estructura protoent . Una aplicación nunca debe intentar modificar esta estructura o liberar cualquiera de sus componentes. Además, al igual que hostent, solo se asigna una copia de esta estructura por subproceso, por lo que la aplicación debe copiar cualquier información que necesite antes de emitir cualquier otra llamada de función de Windows Sockets.
Windows Phone 8: esta función es compatible con las aplicaciones de Windows Phone Store en Windows Phone 8 y versiones posteriores.
Windows 8.1 y Windows Server 2012 R2: esta función es compatible con las aplicaciones de la Tienda Windows en Windows 8.1, Windows Server 2012 R2 y versiones posteriores.
Requisitos
| Requisito | Value |
|---|---|
| Cliente mínimo compatible | Windows 8.1, Windows Vista [aplicaciones de escritorio | Aplicaciones para UWP] |
| Servidor mínimo compatible | Windows Server 2003 [aplicaciones de escritorio | aplicaciones para UWP] |
| Plataforma de destino | Windows |
| Encabezado | winsock.h (incluya Winsock2.h) |
| Library | Ws2_32.lib |
| Archivo DLL | Ws2_32.dll |