CAsyncSocket::GetSockOpt

bool GetSockOpt ( int nOptionName, void * lpOptionValue, int * lpOptionLen, int nLevel = sol_socket );

Dönüş değeri

İşlev başarılı olursa sıfırdan farklı; Aksi halde 0 ve belirli bir hata kodu GetLastErrorçağırarak alınabilir. Bir seçenek asla SetSockOptile kuruldu, GetSockOpt seçeneği varsayılan değer döndürür. Üye işlev aşağıdaki hataları uygulama:

WSA&NOTINITIALISEDnbsp; Başarılı bir AfxSocketInit bu API kullanarak önce meydana gerekir.
wsae&netdownnbsp; Windows Sockets uygulaması ağ alt sistemi başarısız olduğunu tespit.
wsaefault LpOptionLen bağımsız değişken geçersiz.
WSAEI&NPROGRESSnbsp; Engelleme Windows yuva işlemi devam ediyor.
wsaenoprotooptnbsp; Bilinmeyen veya desteklenmeyen bir seçenektir. so_acceptconn, SO_DO&NTLINGER, SO_KEEPALIVE, SO_LINGERve SO_OOBINLINE türü sock_dgram yuvalarda desteklenmez ise özellikle so_broadcast türü sock_stream, yuvalarda desteklenmiyor.
wsae¬socknbsp; Bir soket tanımlayıcısı değil.

Parametreleri

nOptionName

Değer alınacak olan yuva seçeneği.

lpOptionValue

Arabellek istenen seçeneğindeki değere döndürülecek olduğu için bir işaretçi. Seçili seçeneği ile ilişkili değer içinde lpOptionValuearabellek döndürdü. LpOptionLen tarafından işaret tamsayı başlangıçta bu arabelleğinin bayt cinsinden boyutunu içermelidir; ve getirisi, bu döndürülen değer boyutu için ayarlanır. SO_LINGERiçin bu LINGER yapısı olacak; diğer tüm seçenekler için bool veya int, seçeneğe bağlı olacaktır. Seçenekleri ve boyutlarının açıklamalar bölümüne bakınız.

lpOptionLen

LpOptionValue arabelleğinin bayt cinsinden boyutunu gösteren bir işaretçi.

nLevel

Seçenek tanımlandığı düzey; sol_socket ve IPPROTO_TCP sadece desteklenen düzeyleri şunlardır.

Açıklamalar

Bir soket seçeneği almak için bu üye işlevini çağırın. GetSockOpt , herhangi bir durumda, herhangi türde bir yuva ilişkili bir soket seçeneği için geçerli değerini alır ve lpOptionValueiçinde sonucu depolar. Seçenekler, paket, bant veri aktarımı ve benzeri üretim gibi soket işlemleri etkiler.

GetSockOptiçin aşağıdaki seçenekleri destekler. LpOptionValuetarafından gönderilen veri türü tanımlar. Seviye IPPROTO_TCP tcp_nodelay seçeneğini kullanır; diğer tüm seçenekler düzeyi sol_socket kullanın.

Değer	Türü	Anlamı
SO_ACCEPTCONN	BOOL	Soketi dinleme.
SO_BROADCAST	BOOL	Soket yayın iletileri iletim için yapılandırılmış.
SO_DEBUG	BOOL	Hata ayıklama etkin.
SO_DONTLINGER	BOOL	TRUE ise, SO_LINGER seçeneği devre dışı bırakılır.
SO_DONTROUTE	BOOL	Yolu devre dışı bırakılmıştır.
SO_ERROR	int	Hata durumu almak ve temizleyin.
SO_KEEPALIVE	BOOL	Tutma gönderiliyor.
SO_LINGER	struct LINGER	Geçerli linger seçeneklerini döndürür.
SO_OOBINLINE	BOOL	Band dışı veri normal veri akışı alyndy?y zaman.
SO_RCVBUF	int	Alır arabellek boyutu.
SO_REUSEADDR	BOOL	Soket zaten kullanılmakta olan bir adresi bağlanabilir.
SO_SNDBUF	int	Arabellek boyutu gönderir.
SO_TYPE	int	(Örneğin, sock_stream) soket türü.
TCP_NODELAY	BOOL	Gönder coalescing Nagle algoritması devre dışı bırakır.

Berkeley yazılım dağıtımı (bsd) seçenekleri için GetSockOpt desteklenmiyor:

Değer	Türü	Anlamı
SO_RCVLOWAT	int	Düşük su işareti almak.
SO_RCVTIMEO	int	Alma zaman aşımı.
SO_SNDLOWAT	int	Düşük su işareti Gönder.
SO_SNDTIMEO	int	Zaman aşımı Gönder.
IP_OPTIONS		IP üstbilgisinde seçenekleri alırsınız.
TCP_MAXSEG	int	Tcp en fazla kesim boyutu olsun.

GetSockOpt desteklenmeyen bir seçeneği ile arama GetLastError iade edilen wsaenoprotoopt hata kodu sonuçlanır.

CAsyncSocket genel bakış |nbsp; Sınıf üyeleri | Hiyerarşi çizelgesi

Ayrıca bkz: CAsyncSocket::SetSockOpt

Index