CSocketAddr Sınıfı

Uyarı

Etkin Şablon Kitaplığı (ATL) desteklenmeye devam eder. Ancak artık özellik eklemeyeceğiz veya belgeleri güncelleştirmeyeceğiz.

Bu sınıf, konak adlarını konak adreslerine dönüştürmek için hem IPv4 hem de IPV6 biçimlerini destekleyen yöntemler sağlar.

Sözdizimi

class CSocketAddr

Üyeler

Ortak Oluşturucular

Veri Akışı Adı Açıklama
CSocketAddr::CSocketAddr Oluşturucu.

Genel Yöntemler

Veri Akışı Adı Açıklama
CSocketAddr::FindAddr Sağlanan ana bilgisayar adını konak adresine dönüştürmek için bu yöntemi çağırın.
CSocketAddr::FindINET4Addr IPv4 ana bilgisayar adını konak adresine dönüştürmek için bu yöntemi çağırın.
CSocketAddr::FindINET6Addr IPv6 ana bilgisayar adını konak adresine dönüştürmek için bu yöntemi çağırın.
CSocketAddr::GetAddrInfo Listedeki belirli bir öğeye işaretçi döndürmek için bu yöntemi çağırın addrinfo .
CSocketAddr::GetAddrInfoList Listeye bir işaretçi döndürmek için bu yöntemi çağırın addrinfo .

Açıklamalar

Bu sınıf, kitaplıklardaki Windows yuva API işlevleri ve yuva sarmalayıcıları ile kullanılacak ağ adreslerini aramak için IP sürümü belirsiz bir yaklaşım sağlar.

Ağ adreslerini aramak için kullanılan bu sınıfın üyeleri getaddrinfo Win32 API işlevini kullanır. İşlevin ANSI veya UNICODE sürümü, kodunuzun ANSI veya UNICODE için derlenip derlenmiş olmamasına bağlı olarak çağrılır.

Bu sınıf hem IPv4 hem deIPv6 ağ adreslerini destekler.

Gereksinimler

Üst bilgi: atlsocket.h

CSocketAddr::CSocketAddr

Oluşturucu.

CSocketAddr();

Açıklamalar

Yeni CSocketAddr bir nesne oluşturur ve konak hakkındaki yanıt bilgilerini içeren bağlantılı listeyi başlatır.

CSocketAddr::FindAddr

Sağlanan ana bilgisayar adını konak adresine dönüştürmek için bu yöntemi çağırın.

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);

Parametreler

szHost
Ana bilgisayar adı veya noktalı IP adresi.

szPortOrServiceName
Konakta hizmet bağlantı noktası numarası veya adı.

nPortNo
Bağlantı noktası numarası.

Bayrak
0 veya AI_PASSIVE, AI_CANONNAME veya AI_NUMERICHOST birleşimi.

addr_family
Adres ailesi (PF_INET gibi).

sock_type
Yuva türü (SOCK_STREAM gibi).

ai_proto
Protokol (IPPROTO_IP veya IPPROTO_IPV6 gibi).

Dönüş Değeri

Adres başarıyla hesaplanırsa sıfır döndürür. Hata durumunda sıfır olmayan bir Windows Yuvası hata kodu döndürür. Başarılı olursa, hesaplanan adres ve CSocketAddr::GetAddrInfoListkullanılarak CSocketAddr::GetAddrInfo başvurulabilecek bağlantılı bir listede depolanır.

Açıklamalar

Konak adı parametresi IPv4 veya IPv6 biçiminde olabilir. Bu yöntem, dönüştürmeyi gerçekleştirmek için Win32 API işlevi getaddrinfo'sunu çağırır.

CSocketAddr::FindINET4Addr

IPv4 ana bilgisayar adını konak adresine dönüştürmek için bu yöntemi çağırın.

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

Parametreler

szHost
Ana bilgisayar adı veya noktalı IP adresi.

nPortNo
Bağlantı noktası numarası.

Bayrak
0 veya AI_PASSIVE, AI_CANONNAME veya AI_NUMERICHOST birleşimi.

sock_type
Yuva türü (SOCK_STREAM gibi).

Dönüş Değeri

Adres başarıyla hesaplanırsa sıfır döndürür. Hata durumunda sıfır olmayan bir Windows Yuvası hata kodu döndürür. Başarılı olursa, hesaplanan adres ve CSocketAddr::GetAddrInfoListkullanılarak CSocketAddr::GetAddrInfo başvurulabilecek bağlantılı bir listede depolanır.

Açıklamalar

Bu yöntem, dönüştürmeyi gerçekleştirmek için Win32 API işlevi getaddrinfo'sunu çağırır.

CSocketAddr::FindINET6Addr

IPv6 ana bilgisayar adını konak adresine dönüştürmek için bu yöntemi çağırın.

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

Parametreler

szHost
Ana bilgisayar adı veya noktalı IP adresi.

nPortNo
Bağlantı noktası numarası.

Bayrak
0 veya AI_PASSIVE, AI_CANONNAME veya AI_NUMERICHOST birleşimi.

sock_type
Yuva türü (SOCK_STREAM gibi).

Dönüş Değeri

Adres başarıyla hesaplanırsa sıfır döndürür. Hata durumunda sıfır olmayan bir Windows Yuvası hata kodu döndürür. Başarılı olursa, hesaplanan adres ve CSocketAddr::GetAddrInfoListkullanılarak CSocketAddr::GetAddrInfo başvurulabilecek bağlantılı bir listede depolanır.

Açıklamalar

Bu yöntem, dönüştürmeyi gerçekleştirmek için Win32 API işlevi getaddrinfo'sunu çağırır.

CSocketAddr::GetAddrInfo

Listedeki belirli bir öğeye işaretçi döndürmek için bu yöntemi çağırın addrinfo .

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

Parametreler

nIndex
Addrinfo listesindeki belirli bir öğeye başvuru.

Dönüş Değeri

Konak hakkındaki yanıt bilgilerini içeren bağlantılı listede nIndexaddrinfobaşvuruda bulunılan yapıya yönelik bir işaretçi döndürür.

CSocketAddr::GetAddrInfoList

Listeye bir işaretçi döndürmek için bu yöntemi çağırın addrinfo .

addrinfo* const GetAddrInfoList() const;

Dönüş Değeri

Konakla ilgili yanıt bilgilerini içeren bir veya daha fazla addrinfo yapıdan oluşan bağlantılı listeye yönelik işaretçi. Daha fazla bilgi için bkz . addrinfo yapısı.

Ayrıca bkz.

Sınıfa Genel Bakış