Compartir a través de

Función getservbyport (winsock.h)

  • Artículo

La función getservbyport recupera la información del servicio correspondiente a un puerto y protocolo.

Sintaxis

servent * getservbyport(
  [in] int        port,
  [in] const char *proto
);

Parámetros

[in] port

Puerto para un servicio, en orden de bytes de red.

[in] proto

Puntero opcional a un nombre de protocolo. Si es null, getservbyport devuelve la primera entrada de servicio para la que el puerto coincide con el s_port de la estructura servent . De lo contrario, getservbyport coincide con el puerto y los parámetros proto .

Valor devuelto

Si no se produce ningún error, getservbyport devuelve un puntero a la estructura servent . 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 de WSAStartup correcta antes de usar esta función.
WSAENETDOWN
 Error en el subsistema de red.
WSAHOST_NOT_FOUND
 No se encontró el servicio de respuesta autoritativa.
WSATRY_AGAIN
 No se encontró un servicio no autenticado o un error en el servidor.
WSANO_RECOVERY
 Errores irrecuperables, no se puede acceder a la base de datos de servicios.
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.
WSAEFAULT
 El parámetro proto no es una parte válida del espacio de direcciones del usuario.
WSAEINTR
 Se canceló una llamada de Bloqueo de Windows Socket 1.1 a través de WSACancelBlockingCall.

Comentarios

La función getservbyport devuelve un puntero a una estructura servent como lo hace en la función getservbyname .

Windows Sockets asigna la estructura servent . 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

WSAAsyncGetServByPort

Funciones winsock

Referencia de Winsock

getservbyname