Clase CSocketAddrCSocketAddr Class

Esta clase proporciona métodos para convertir nombres de host en direcciones de host, lo que admite los formatos IPv4 e IPV6.This class provides methods for converting host names to host addresses, supporting both IPv4 and IPV6 formats.

SintaxisSyntax

class CSocketAddr

MiembrosMembers

Constructores públicosPublic Constructors

NombreName DescripciónDescription
CSocketAddr::CSocketAddrCSocketAddr::CSocketAddr El constructor.The constructor.

Métodos públicosPublic Methods

NombreName DescripciónDescription
CSocketAddr::FindAddrCSocketAddr::FindAddr Llame a este método para convertir el nombre de host proporcionado a la dirección de host.Call this method to convert the provided host name to the host address.
CSocketAddr::FindINET4AddrCSocketAddr::FindINET4Addr Llame a este método para convertir el nombre de host IPv4 en la dirección de host.Call this method to convert the IPv4 host name to the host address.
CSocketAddr::FindINET6AddrCSocketAddr::FindINET6Addr Llame a este método para convertir el nombre de host IPv6 a la dirección de host.Call this method to convert the IPv6 host name to the host address.
CSocketAddr::GetAddrInfoCSocketAddr::GetAddrInfo Llame a este método para devolver un addrinfo puntero a un elemento específico de la lista.Call this method to return a pointer to a specific element in the addrinfo list.
CSocketAddr::GetAddrInfoListCSocketAddr::GetAddrInfoList Llame a este método para addrinfo devolver un puntero a la lista.Call this method to return a pointer to the addrinfo list.

ObservacionesRemarks

Esta clase proporciona un enfoque independiente de la versión IP para buscar direcciones de red para su uso con funciones de API de sockets de Windows y contenedores de socket en bibliotecas.This class provides an IP version agnostic approach for looking up network addresses for use with Windows sockets API functions and socket wrappers in libraries.

Los miembros de esta clase que se utilizan para buscar direcciones de red utilizan la función de API de Win32 getaddrinfo.The members of this class that are used to look up network addresses use the Win32 API function getaddrinfo. Se llama a la versión ANSI o UNICODE de la función en función de si el código se compila para ANSI o UNICODE.The ANSI or UNICODE version of the function is called depending on whether your code is compiled for ANSI or UNICODE.

Esta clase admite direcciones de red IPv4 e IPv6.This class supports both IPv4 andIPv6 network addresses.

RequisitosRequirements

Encabezado: atlsocket.hHeader: atlsocket.h

CSocketAddr::CSocketAddrCSocketAddr::CSocketAddr

El constructor.The constructor.

CSocketAddr();

ObservacionesRemarks

Crea un CSocketAddr nuevo objeto e inicializa la lista vinculada que contiene información de respuesta sobre el host.Creates a new CSocketAddr object and initializes the linked list containing response information about the host.

CSocketAddr::FindAddrCSocketAddr::FindAddr

Llame a este método para convertir el nombre de host proporcionado a la dirección de host.Call this method to convert the provided host name to the host address.

int FindAddr(
    const TCHAR *szHost,
    const TCHAR *szPortOrServiceName,
    int flags,
    int addr_family,
    int sock_type,
    int ai_proto);

int FindAddr(
    const TCHAR *szHost,
    int nPortNo,
    int flags,
    int addr_family,
    int sock_type,
    int ai_proto);

ParámetrosParameters

szHostszHost
El nombre de host o la dirección IP punteada.The host name or dotted IP address.

szPortOrServiceNameszPortOrServiceName
El número de puerto o el nombre del servicio en el host.The port number or name of service on host.

nPortNonPortNo
Número del puerto.The port number.

Banderasflags
0 o combinación de AI_PASSIVE, AI_CANONNAME o AI_NUMERICHOST.0 or combination of AI_PASSIVE, AI_CANONNAME or AI_NUMERICHOST.

addr_familyaddr_family
Familia de direcciones (como PF_INET).Address family (such as PF_INET).

sock_typesock_type
Tipo de socket (por ejemplo, SOCK_STREAM).Socket type (such as SOCK_STREAM).

ai_protoai_proto
Protocolo (como IPPROTO_IP o IPPROTO_IPV6).Protocol (such as IPPROTO_IP or IPPROTO_IPV6).

Valor devueltoReturn Value

Devuelve cero si la dirección se calcula correctamente.Returns zero if the address is calculated successfully. Devuelve un código de error de Windows Socket distinto de cero en caso de error.Returns a nonzero Windows Socket error code on failure. Si se realiza correctamente, la dirección calculada se almacena CSocketAddr::GetAddrInfoList CSocketAddr::GetAddrInfoen una lista vinculada a la que se puede hacer referencia mediante y .If successful, the calculated address is stored in a linked list that may be referenced using CSocketAddr::GetAddrInfoList and CSocketAddr::GetAddrInfo.

ObservacionesRemarks

El parámetro de nombre de host puede estar en formato IPv4 o IPv6.The host name parameter may be in either IPv4 or IPv6 format. Este método llama a la función getaddrinfo de la API de Win32 para realizar la conversión.This method calls the Win32 API function getaddrinfo to perform the conversion.

CSocketAddr::FindINET4AddrCSocketAddr::FindINET4Addr

Llame a este método para convertir el nombre de host IPv4 en la dirección de host.Call this method to convert the IPv4 host name to the host address.

int FindINET4Addr(
    const TCHAR *szHost,
    int nPortNo,
    int flags = 0,
    int sock_type = SOCK_STREAM);

ParámetrosParameters

szHostszHost
El nombre de host o la dirección IP punteada.The host name or dotted IP address.

nPortNonPortNo
Número del puerto.The port number.

Banderasflags
0 o combinación de AI_PASSIVE, AI_CANONNAME o AI_NUMERICHOST.0 or combination of AI_PASSIVE, AI_CANONNAME or AI_NUMERICHOST.

sock_typesock_type
Tipo de socket (por ejemplo, SOCK_STREAM).Socket type (such as SOCK_STREAM).

Valor devueltoReturn Value

Devuelve cero si la dirección se calcula correctamente.Returns zero if the address is calculated successfully. Devuelve un código de error de Windows Socket distinto de cero en caso de error.Returns a nonzero Windows Socket error code on failure. Si se realiza correctamente, la dirección calculada se almacena CSocketAddr::GetAddrInfoList CSocketAddr::GetAddrInfoen una lista vinculada a la que se puede hacer referencia mediante y .If successful, the calculated address is stored in a linked list that may be referenced using CSocketAddr::GetAddrInfoList and CSocketAddr::GetAddrInfo.

ObservacionesRemarks

Este método llama a la función getaddrinfo de la API de Win32 para realizar la conversión.This method calls the Win32 API function getaddrinfo to perform the conversion.

CSocketAddr::FindINET6AddrCSocketAddr::FindINET6Addr

Llame a este método para convertir el nombre de host IPv6 a la dirección de host.Call this method to convert the IPv6 host name to the host address.

int FindINET6Addr(
    const TCHAR *szHost,
    int nPortNo,
    int flags = 0,
    int sock_type = SOCK_STREAM);

ParámetrosParameters

szHostszHost
El nombre de host o la dirección IP punteada.The host name or dotted IP address.

nPortNonPortNo
Número del puerto.The port number.

Banderasflags
0 o combinación de AI_PASSIVE, AI_CANONNAME o AI_NUMERICHOST.0 or combination of AI_PASSIVE, AI_CANONNAME or AI_NUMERICHOST.

sock_typesock_type
Tipo de socket (por ejemplo, SOCK_STREAM).Socket type (such as SOCK_STREAM).

Valor devueltoReturn Value

Devuelve cero si la dirección se calcula correctamente.Returns zero if the address is calculated successfully. Devuelve un código de error de Windows Socket distinto de cero en caso de error.Returns a nonzero Windows Socket error code on failure. Si se realiza correctamente, la dirección calculada se almacena CSocketAddr::GetAddrInfoList CSocketAddr::GetAddrInfoen una lista vinculada a la que se puede hacer referencia mediante y .If successful, the calculated address is stored in a linked list that may be referenced using CSocketAddr::GetAddrInfoList and CSocketAddr::GetAddrInfo.

ObservacionesRemarks

Este método llama a la función getaddrinfo de la API de Win32 para realizar la conversión.This method calls the Win32 API function getaddrinfo to perform the conversion.

CSocketAddr::GetAddrInfoCSocketAddr::GetAddrInfo

Llame a este método para devolver un addrinfo puntero a un elemento específico de la lista.Call this method to return a pointer to a specific element in the addrinfo list.

addrinfo* const GetAddrInfo(int nIndex = 0) const;

ParámetrosParameters

nIndexnIndex
Una referencia a un elemento específico de la lista addrinfo.A reference to a specific element in the addrinfo list.

Valor devueltoReturn Value

Devuelve un puntero addrinfo a la estructura a la que hace referencia nIndex en la lista vinculada que contiene información de respuesta sobre el host.Returns a pointer to the addrinfo structure referenced by nIndex in the linked list containing response information about the host.

CSocketAddr::GetAddrInfoListCSocketAddr::GetAddrInfoList

Llame a este método para addrinfo devolver un puntero a la lista.Call this method to return a pointer to the addrinfo list.

addrinfo* const GetAddrInfoList() const;

Valor devueltoReturn Value

Puntero a una lista vinculada addrinfo de una o más estructuras que contienen información de respuesta sobre el host.Pointer to a linked list of one or more addrinfo structures containing response information about the host. Para obtener más información, consulte estructura addrinfo.For more information, see addrinfo structure.

Consulte tambiénSee also

Información general de clasesClass Overview