Compartir a través de


Función getprotobynumber (winsock.h)

La función getprotobynumber recupera la información del protocolo correspondiente a un número de protocolo.

Sintaxis

protoent * getprotobynumber(
  int proto
);

Parámetros

proto

TBD

Valor devuelto

Si no se produce ningún error, getprotobynumber devuelve un puntero a la estructura 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
WSANOTINITIALISED
Debe producirse una llamada WSAStartup correcta antes de usar esta función.
WSAENETDOWN
Error en el subsistema de red.
WSAHOST_NOT_FOUND
No se encontró el protocolo de respuesta autoritativa.
WSATRY_AGAIN
No se encontró un protocolo no autenticado o un error en el servidor.
WSANO_RECOVERY
Errores irrecuperables, la base de datos de protocolos no es accesible.
WSANO_DATA
Nombre válido, sin registro de datos del tipo solicitado.
WSAEINPROGRESS
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.
WSAEINTR
Se canceló una llamada de Bloqueo de Windows Socket 1.1 a través de WSACancelBlockingCall.

Comentarios

Esta función getprotobynumber devuelve un puntero a la estructura protoent como se ha descrito anteriormente en getprotobyname. El contenido de la estructura corresponde al número de protocolo especificado.

El puntero que se devuelve apunta a la estructura asignada por Windows Sockets. La aplicación nunca debe intentar modificar esta estructura o liberar cualquiera de sus componentes. Además, 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

Consulte también

WSAAsyncGetProtoByNumber

Funciones winsock

Referencia de Winsock

getprotobyname