getsockopt-Funktion (winsock.h)

Artikel
08/27/2023

Die getockopt-Funktion ruft eine Socketoption ab.

Syntax

int getsockopt(
  [in]      SOCKET s,
  [in]      int    level,
  [in]      int    optname,
  [out]     char   *optval,
  [in, out] int    *optlen
);

Parameter

[in] s

Ein Deskriptor, der einen Socket identifiziert.

[in] level

Die Ebene, auf der die Option definiert ist. Beispiel: SOL_SOCKET.

[in] optname

Die Socketoption, für die der Wert abgerufen werden soll. Beispiel: SO_ACCEPTCONN. Der Optname-Wert muss eine Socketoption sein, die innerhalb der angegebenen Ebene definiert ist, oder das Verhalten ist nicht definiert.

[out] optval

Ein Zeiger auf den Puffer, in dem der Wert für die angeforderte Option zurückgegeben werden soll.

[in, out] optlen

Ein Zeiger auf die Größe des Optval-Puffers in Bytes.

Rückgabewert

Wenn kein Fehler auftritt, gibt getsockopt null zurück. Andernfalls wird der Wert SOCKET_ERROR zurückgegeben, und ein bestimmter Fehlercode kann durch Aufrufen von WSAGetLastError abgerufen werden.

Fehlercode	Bedeutung
WSANOTINITIALISIERT	Vor der Verwendung dieser Funktion muss ein erfolgreicher WSAStartup-Aufruf erfolgen.
WSAENETDOWN	Hinweis Beim Netzwerksubsystem ist ein Fehler aufgetreten.
WSAEFAULT	Einer der optval - oder optlen-Parameter ist kein gültiger Teil des Benutzeradressraums, oder der optlen-Parameter ist zu klein.
WSAEINPROGRESS	Ein blockierter Windows Sockets 1.1-Aufruf wird ausgeführt, oder der Dienstanbieter verarbeitet weiterhin eine Rückruffunktion.
WSAEINVAL	Der Levelparameter ist unbekannt oder ungültig.
WSAENOPROTOOPT	Die Option ist unbekannt oder wird von der angegebenen Protokollfamilie nicht unterstützt.
WSAENOTSOCK	Der Deskriptor ist kein Socket.

Hinweise

Die getockopt-Funktion ruft den aktuellen Wert für eine Socketoption ab, die einem Socket eines beliebigen Typs in einem beliebigen Zustand zugeordnet ist, und speichert das Ergebnis in optval. Optionen können auf mehreren Protokollebenen vorhanden sein, sind aber immer auf der obersten Socketebene vorhanden. Optionen wirken sich auf Socketvorgänge aus, z. B. das Paketrouting und die OOB-Datenübertragung.

Der der ausgewählten Option zugeordnete Wert wird im Puffer optval zurückgegeben. Die ganze Zahl, auf die von optlen verwiesen wird, sollte ursprünglich die Größe dieses Puffers enthalten. bei der Rückgabe wird die Größe des zurückgegebenen Werts festgelegt. Für SO_LINGER ist dies die Größe einer LINGER-Struktur . Bei den meisten anderen Optionen entspricht dies der Größe einer ganzzahligen Zahl.

Die Anwendung ist für die Zuweisung von Speicherplatz verantwortlich, auf den direkt oder indirekt durch einen der angegebenen Parameter verwiesen wird.

Wenn die Option nie mit setsockopt festgelegt wurde, gibt getsockopt den Standardwert für die Option zurück.

Die folgenden Optionen werden für getsockopt unterstützt. Die Spalte Typ gibt den Typ der von optval adressierten Daten an.

Weitere Informationen zu Socketoptionen finden Sie unter Socketoptionen.

Die folgende Werttabelle für den optname-Parameter ist gültig, wenn der Levelparameter auf SOL_SOCKET festgelegt ist.

Wert	Typ	Bedeutung
SO_ACCEPTCONN	BOOL	Der Socket überwacht.
SO_BROADCAST	BOOL	Der Socket ist für die Übertragung und den Empfang von Broadcastnachrichten konfiguriert.
SO_BSP_STATE	CSADDR_INFO	Gibt die lokale Adresse, den lokalen Port, die Remoteadresse, den Remoteport, den Sockettyp und das Protokoll zurück, die von einem Socket verwendet werden.
SO_CONDITIONAL_ACCEPT	BOOL	Gibt den aktuellen Socketstatus zurück, entweder von einem vorherigen Aufruf von setsockopt oder vom Systemstandard.
SO_CONNECT_TIME	DWORD	Gibt die Anzahl der Sekunden zurück, die ein Socket verbunden wurde. Diese Socketoption ist nur für verbindungsorientierte Protokolle gültig.
SO_DEBUG	BOOL	Debuggen ist aktiviert.
SO_DONTLINGER	BOOL	Bei TRUE ist die Option SO_LINGER deaktiviert.
SO_DONTROUTE	BOOL	Routing ist deaktiviert. Das Festlegen ist erfolgreich, wird aber für AF_INET Sockets ignoriert. tritt bei AF_INET6 Sockets mit WSAENOPROTOOPT aus. Diese Option wird für ATM-Sockets nicht unterstützt.
SO_ERROR	INT	Ruft Fehler status ab und löscht sie ab.
SO_EXCLUSIVEADDRUSE	BOOL	Verhindert, dass ein anderer Socket an dieselbe Adresse und denselben Port gebunden wird. Diese Option muss vor dem Aufrufen der Bindungsfunktion festgelegt werden.
SO_GROUP_ID	GROUP	Reserviert.
SO_GROUP_PRIORITY	INT	Reserviert.
SO_KEEPALIVE	BOOL	Keep-Alives werden gesendet. Wird für ATM-Sockets nicht unterstützt.
SO_LINGER	LINGER-Struktur	Gibt die aktuellen Optionen für das Verweilen zurück.
SO_MAX_MSG_SIZE	unsigned int	Die maximale Größe einer Nachricht für nachrichtenorientierte Sockettypen (z. B. SOCK_DGRAM). Hat keine Bedeutung für streamorientierte Sockets.
SO_OOBINLINE	BOOL	OOB-Daten werden im normalen Datenstrom empfangen. (Eine Diskussion zu diesem Thema finden Sie im Abschnitt Blockieren von Routinen für Windows Sockets 1.1 und EINPROGRESS .)
SO_PORT_SCALABILITY	BOOL	Ermöglicht die Skalierbarkeit des lokalen Ports für einen Socket, indem die Portzuordnung durch mehrfaches Zuweisen von Platzhalterports für verschiedene lokale Adressportpaare auf einem lokalen Computer maximiert werden kann.
SO_PROTOCOL_INFO	WSAPROTOCOL_INFO	Eine Beschreibung der Protokollinformationen für das Protokoll, das an diesen Socket gebunden ist.
SO_RCVBUF	INT	Der gesamt reservierte Pufferspeicher pro Socket für empfänge. Dies hat nichts mit SO_MAX_MSG_SIZE zu tun und entspricht nicht unbedingt der Größe des TCP-Empfangsfensters.
SO_REUSEADDR	BOOL	Der Socket kann an eine Adresse gebunden werden, die bereits verwendet wird. Gilt nicht für ATM-Sockets.
SO_SNDBUF	INT	Der gesamt reservierte Pufferspeicher pro Socket für Senden. Dies hat nichts mit SO_MAX_MSG_SIZE zu tun und entspricht nicht unbedingt der Größe eines TCP-Sendefensters.
SO_TYPE	INT	Der Typ des Sockets (z. B. SOCK_STREAM).
PVD_CONFIG	Dienstanbieterabhängig	Ein undurchsichtiges Datenstrukturobjekt des Dienstanbieters, der Sockets s zugeordnet ist. Dieses Objekt speichert die aktuellen Konfigurationsinformationen des Dienstanbieters. Das genaue Format dieser Datenstruktur ist dienstanbieterspezifisch.

Ebene = IPPROTO_TCP

Weitere Informationen finden Sie unter TCP_NODELAY in IPPROTO_TCP Socketoptionen. Ausführlichere und ausführlichere Informationen zu Socketoptionen für IPPROTO_TCP = finden Sie auch indiesem Thema.

Die folgende Werttabelle für den optname-Parameter ist gültig, wenn der Levelparameter auf NSPROTO_IPX festgelegt ist.

Hinweis Windows NT unterstützt alle IPX-Optionen. Windows Me, Windows 98 und Windows 95 unterstützen nur die folgenden Optionen:

IPX_PTYPE

IPX_FILTERPTYPE

IPX_DSTYPE

IPX_RECVHDR

IPX_MAXSIZE

IPX_ADDRESS

Wert	Typ	Bedeutung
IPX_PTYPE	INT	Ruft den IPX-Pakettyp ab.
IPX_FILTERPTYPE	INT	Ruft den Pakettyp des Empfangsfilters ab.
IPX_DSTYPE	INT	Ruft den Wert des Datenstromfelds im SPX-Header für jedes gesendete Paket ab.
IPX_EXTENDED_ADDRESS	BOOL	Ermittelt, ob die erweiterte Adressierung aktiviert ist.
IPX_RECVHDR	BOOL	Ermittelt, ob der Protokollheader für alle Empfangsheader gesendet wird.
IPX_MAXSIZE	INT	Ruft die maximale Datengröße ab, die gesendet werden kann.
IPX_ADDRESS	IPX_ADDRESS_DATA Struktur	Ruft Informationen zu einem bestimmten Adapter ab, an den IPX gebunden ist. Die Adapternummerierung ist Basisnull. Das adapternum-Element wird bei der Rückgabe ausgefüllt.
IPX_GETNETINFO	IPX_NETNUM_DATA Struktur	Ruft Informationen zu einer bestimmten IPX-Netzwerknummer ab. Falls nicht im Cache verfügbar, wird RIP zum Abrufen von Informationen verwendet.
IPX_GETNETINFO_NORIP	IPX_NETNUM_DATA Struktur	Ruft Informationen zu einer bestimmten IPX-Netzwerknummer ab. Wenn im Cache nicht verfügbar ist, wird RIP nicht zum Abrufen von Informationen verwendet, und gibt einen Fehler zurück.
IPX_SPXGETCONNECTIONSTATUS	IPX_SPXCONNSTATUS_DATA Struktur	Ruft Informationen zu einem verbundenen SPX-Socket ab.
IPX_ADDRESS_NOTIFY	IPX_ADDRESS_DATA Struktur	Ruft status Benachrichtigung ab, wenn Änderungen an einem Adapter auftreten, an den IPX gebunden ist.
IPX_MAX_ADAPTER_NUM	INT	Ruft die maximale Anzahl vorhandener Adapter ab, nummeriert als Basisnull.
IPX_RERIPNETNUMBER	IPX_NETNUM_DATA Struktur	Ähnlich wie IPX_GETNETINFO, erzwingt aber IPX, RIP für die Auflösung zu verwenden, auch wenn sich die Netzwerkinformationen im lokalen Cache befinden.
IPX_IMMEDIATESPXACK	BOOL	Weist SPX-Verbindungen an, vor dem Senden eines ACK nicht zu verzögern. Anwendungen ohne Hin- und Her-Datenverkehr sollten dies auf TRUE festlegen, um die Leistung zu erhöhen.
TCP_MAXSEG	INT	Empfängt die maximale TCP-Segmentgröße. Wird in Windows 10 und neueren Versionen unterstützt.

In der folgenden Tabelle ist der Wert für den Optname aufgeführt, der BSD-Socketoptionen darstellt, die von der getockopt-Funktion nicht unterstützt werden.

Wert	Typ	Bedeutung
SO_RCVLOWAT	INT	Erhält ein niedriges Wasserzeichen.
SO_RCVTIMEO	INT	Empfängt Timeout.
SO_SNDLOWAT	INT	Sendet niedriges Wasserzeichen.
SO_SNDTIMEO	INT	Sendet Timeout.
TCP_MAXSEG	INT	Empfängt die maximale TCP-Segmentgröße. Wird in Versionen vor Windows 10 nicht unterstützt.

Hinweis Wenn sie die recv-Funktion verwenden, wird die recv-Funktion abgeschlossen, wenn während des in SO_RCVTIMEO angegebenen Zeitraums keine Daten eintreffen. In Windows-Versionen vor Windows 2000 führen alle empfangenen Daten zu einem Fehler mit WSAETIMEDOUT. Wenn in Windows 2000 und höher innerhalb des in SO_RCVTIMEO angegebenen Zeitraums keine Daten eintreffen, gibt die recv-Funktion WSAETIMEDOUT zurück, und wenn Daten empfangen werden, gibt recv SUCCESS zurück.

Das Aufrufen von getsockopt mit einer nicht unterstützten Option führt dazu, dass ein Fehlercode von WSAENOPROTOOPT von WSAGetLastError zurückgegeben wird.

Ausführlichere Informationen zu einigen Socketoptionen für den optname-Parameter , der von der getockopt-Funktion unterstützt wird, sind unten aufgeführt.

SO_CONNECT_TIME: Diese Option gibt die Anzahl der Sekunden zurück, die ein Socket verbunden wurde. Diese Option gilt nur für verbindungsorientierte Protokolle.
Die Option SO_CONNECT_TIME kann mit der getockopt-Funktion verwendet werden, um zu überprüfen, ob eine Verbindung hergestellt wurde. Diese Option kann auch verwendet werden, während ein ConnectEx-Funktionsaufruf ausgeführt wird. Wenn eine Verbindung hergestellt wird, kann die Option SO_CONNECT_TIME bestimmen, wie lange die Verbindung hergestellt wurde. Wenn der Socket nicht verbunden ist, gibt der getsockopt SOCKET_ERROR zurück. Eine solche Verbindung zu überprüfen ist erforderlich, um festzustellen, ob Verbindungen, die seit einer Weile eingerichtet wurden, ohne Daten zu senden. Es wird empfohlen, diese Verbindungen von Anwendungen zu beenden.
SO_DEBUG: Hinweis Windows Sockets-Dienstanbieter werden ermutigt (aber nicht erforderlich), Ausgabedebuginformationen bereitzustellen, wenn die Option SO_DEBUG von einer Anwendung festgelegt wird. Der Mechanismus zum Generieren der Debuginformationen und der benötigten Form sprengt den Geltungsbereich dieses Dokuments.
SO_ERROR: Die option SO_ERROR gibt den pro Socket basierenden Fehlercode zurück und setzt diesen zurück, der sich von dem pro threadbasierten Fehlercode unterscheidet, der mithilfe der Funktionsaufrufe WSAGetLastError und WSASetLastError verarbeitet wird. Ein erfolgreicher Aufruf mithilfe des Sockets setzt den socketbasierten Fehlercode, der von der Option SO_ERROR zurückgegeben wird, nicht zurück.
SO_EXCLUSIVEADDRUSE: Verhindert, dass ein anderer Socket an dieselbe Adresse und denselben Port gebunden wird. Diese Option muss vor dem Aufrufen der Bindungsfunktion festgelegt werden. Weitere Informationen finden Sie in der referenz SO_EXCLUSIVEADDRUSE .
SO_GROUP_ID: Hinweis Diese Option ist reserviert. Diese Option ist auch exklusiv für getsockopt; der Wert sollte NULL sein.
SO_GROUP_PRIORITY: Diese Option ist reserviert. Die Gruppenpriorität gibt die Priorität des angegebenen Sockets im Verhältnis zu anderen Sockets innerhalb der Socketgruppe an. Werte sind nicht abegative ganze Zahlen, wobei null der höchsten Priorität entspricht. Prioritätswerte stellen einen Hinweis an den zugrunde liegenden Dienstanbieter dar, wie potenziell knappe Ressourcen zugeordnet werden sollten. Wenn beispielsweise zwei oder mehr Sockets für die Übertragung von Daten bereit sind, sollte der Socket mit der höchsten Priorität (niedrigster Wert für SO_GROUP_PRIORITY) zuerst gewartet werden, während der rest wiederum entsprechend ihren relativen Prioritäten gewartet wird.
Der WSAENOPROTOOPT-Fehlercode wird für Nicht-Gruppensockets oder für Dienstanbieter angegeben, die keine Gruppensockets unterstützen.
SO_KEEPALIVE: Eine Anwendung kann anfordern, dass ein TCP/IP-Dienstanbieter die Verwendung von Keep-Alive-Paketen für TCP-Verbindungen aktiviert, indem sie die SO_KEEPALIVE Socketoption aktiviert. Diese Option fragt den aktuellen Wert der Keep-Alive-Option für einen Socket ab. Ein Windows Sockets-Anbieter muss die Verwendung von Keep-Alive nicht unterstützen: Wenn dies der Fall ist, ist die genaue Semantik implementierungsspezifisch, sollte jedoch Abschnitt 4.2.3.6 der Anforderungen für Internethosts – Kommunikationsebenen gemäß RFC 1122 entsprechen, die auf der IETF-Website verfügbar sind. Wenn eine Verbindung als Ergebnis von keep-alives abgebrochen wird, wird der Fehlercode WSAENETRESET an alle laufenden Aufrufe des Sockets zurückgegeben, und alle nachfolgenden Aufrufe schlagen mit WSAENOTCONN fehl. SO_KEEPALIVE wird auf ATM-Sockets nicht unterstützt, und Anforderungen zum Aktivieren der Verwendung von Keep-Alive-Paketen auf einem ATM-Socket führen zu einem Fehler, der vom Socket zurückgegeben wird.
SO_LINGER: SO_LINGER steuert die Aktion, die ausgeführt wird, wenn nicht gesendete Daten auf einem Socket in die Warteschlange gestellt werden und ein Closesocket ausgeführt wird. Unter closesocket finden Sie eine Beschreibung der Art und Weise, in der sich die SO_LINGER-Einstellungen auf die Semantik von Closesocket auswirken. Die Anwendung ruft das aktuelle Verhalten ab, indem eine LINGER-Struktur abgerufen wird (auf die der optval-Parameter verweist).
SO_MAX_MSG_SIZE: Dies ist eine get-only-Socketoption, die die maximale ausgehende (Sende-)Größe einer Nachricht für nachrichtenorientierte Sockettypen (z. B. SOCK_DGRAM) angibt, die von einem bestimmten Dienstanbieter implementiert wird. Es hat keine Bedeutung für Bytestrom-orientierte Sockets. Es gibt keine Bereitstellung, um die maximale Größe eingehender Nachrichten zu ermitteln.
SO_PROTOCOL_INFO: Dies ist eine get-only-Option, die die WSAPROTOCOL_INFO Struktur bereitstellt, die diesem Socket zugeordnet ist. Weitere Informationen zu dieser Struktur finden Sie unter WSAEnumProtocols .
SO_SNDBUF: Wenn eine Windows Sockets-Implementierung die optionen SO_RCVBUF und SO_SNDBUF unterstützt, kann eine Anwendung verschiedene Puffergrößen anfordern (größer oder kleiner). Der Aufruf von setsockopt kann auch dann erfolgreich sein, wenn die Implementierung nicht den gesamten angeforderten Betrag bereitgestellt hat. Eine Anwendung muss diese Funktion mit derselben Option aufrufen, um die tatsächlich bereitgestellte Puffergröße zu überprüfen.
SO_REUSEADDR: Standardmäßig kann ein Socket nicht an eine bereits verwendete lokale Adresse gebunden werden (siehe Bind). Gelegentlich kann es jedoch notwendig sein, eine Adresse auf diese Weise wiederzuverwenden. Da jede Verbindung durch die Kombination von lokalen und Remoteadressen eindeutig identifiziert wird, ist es kein Problem, zwei Sockets an dieselbe lokale Adresse gebunden zu haben, solange sich die Remoteadressen unterscheiden. Um den Windows Sockets-Anbieter darüber zu informieren, dass eine Bindung für einen Socket nicht unzulässig sein soll, da die gewünschte Adresse bereits von einem anderen Socket verwendet wird, sollte die Anwendung die Option SO_REUSEADDR Socket für den Socket festlegen, bevor die Bindung ausgegeben wird. Beachten Sie, dass die Option nur zum Zeitpunkt der Bindung interpretiert wird: Es ist daher unnötig (aber harmlos), die Option für einen Socket festzulegen, der nicht an eine vorhandene Adresse gebunden werden soll, und die Option festzulegen oder zurückzusetzen, nachdem die Bindung keine Auswirkungen auf dieses oder einen anderen Socket hat. SO_REUSEADDR gilt nicht für ATM-Sockets, und obwohl Anforderungen zur Wiederverwendung und adressieren nicht zu einem Fehler führen, wirken sie sich nicht darauf aus, wenn ein ATM-Socket verwendet wird.
PVD_CONFIG: Diese Option ruft ein undurchsichtiges Datenstrukturobjekt vom Dienstanbieter ab, der Sockets zugeordnet ist. Dieses Objekt speichert die aktuellen Konfigurationsinformationen des Dienstanbieters. Das genaue Format dieser Datenstruktur ist dienstanbieterspezifisch.
TCP_NODELAY: Die option TCP_NODELAY ist spezifisch für TCP/IP-Dienstanbieter. Der Nagle-Algorithmus ist deaktiviert, wenn die Option TCP_NODELAY aktiviert ist (und umgekehrt). Der Nagle-Algorithmus (beschrieben in RFC 896) ist sehr effektiv bei der Reduzierung der Anzahl kleiner Pakete, die von einem Host gesendet werden. Der Prozess umfasst das Puffern von Sendedaten, wenn nicht bekannte Daten bereits im Flight vorhanden sind, oder das Puffern von Sendedaten, bis ein Paket in voller Größe gesendet werden kann. Es wird dringend empfohlen, dass Windows Sockets-Implementierungen den Nagle-Algorithmus standardmäßig aktivieren, da der Nagle-Algorithmus für die überwiegende Mehrheit der Anwendungsprotokolle erhebliche Leistungsverbesserungen liefern kann. Für einige Anwendungen kann dieser Algorithmus jedoch die Leistung beeinträchtigen, und setsockopt mit derselben Option kann verwendet werden, um ihn zu deaktivieren. Dies sind Anwendungen, bei denen viele kleine Nachrichten gesendet werden und die Zeitverzögerungen zwischen den Nachrichten beibehalten werden.

Hinweis Wenn Sie einen blockierenden Winsock-Aufruf wie getsockopt ausgeben, muss Winsock möglicherweise auf ein Netzwerkereignis warten, bevor der Anruf abgeschlossen werden kann. Winsock führt in dieser Situation eine warnbare Wartezeit aus, die durch einen asynchronen Prozeduraufruf (APC) unterbrochen werden kann, der für denselben Thread geplant ist. Das Ausgeben eines weiteren blockierenden Winsock-Aufrufs in einem APC, der einen fortlaufenden blockierenden Winsock-Aufruf im selben Thread unterbrochen hat, führt zu nicht definiertem Verhalten und darf niemals von Winsock-Clients versucht werden.

Beispielcode

Im folgenden Codebeispiel wird die Verwendung der funktion getsockopt veranschaulicht.

#include <stdio.h>
#include "winsock2.h"
#include <windows.h>

void main() {

  //---------------------------------------
  // Declare variables
  WSADATA wsaData;
  SOCKET ListenSocket;
  sockaddr_in service;

  //---------------------------------------
  // Initialize Winsock
  int iResult = WSAStartup( MAKEWORD(2,2), &wsaData );
  if( iResult != NO_ERROR )
    printf("Error at WSAStartup\n");

  //---------------------------------------
  // Create a listening socket
  ListenSocket = socket( AF_INET, SOCK_STREAM, IPPROTO_TCP );
  if (ListenSocket == INVALID_SOCKET) {
    printf("Error at socket()\n");
    WSACleanup();
    return;
  }

  //---------------------------------------
  // Bind the socket to the local IP address
  // and port 27015
  hostent* thisHost;
  char* ip;
  u_short port;
  port = 27015;
  thisHost = gethostbyname("");
  ip = inet_ntoa (*(struct in_addr *)*thisHost->h_addr_list);

  service.sin_family = AF_INET;
  service.sin_addr.s_addr = inet_addr(ip);
  service.sin_port = htons(port);
 
  if ( bind( ListenSocket,(SOCKADDR*) &service, sizeof(service) )  == SOCKET_ERROR ) {
    printf("bind failed\n");
    closesocket(ListenSocket);
    return;
  }

  //---------------------------------------
  // Initialize variables and call getsockopt. 
  // The SO_ACCEPTCONN parameter is a socket option 
  // that tells the function to check whether the 
  // socket has been put in listening mode or not. 
  // The various socket options return different
  // information about the socket. This call should
  // return 0 to the optVal parameter, since the socket
  // is not in listening mode.
  int optVal;
  int optLen = sizeof(int);

  if (getsockopt(ListenSocket, 
    SOL_SOCKET, 
    SO_ACCEPTCONN, 
    (char*)&optVal, 
    &optLen) != SOCKET_ERROR)
    printf("SockOpt Value: %ld\n", optVal);

  //---------------------------------------
  // Put the listening socket in listening mode.
  if (listen( ListenSocket, 100 ) == SOCKET_ERROR) {
    printf("error listening\n");
  } 

  //---------------------------------------
  // Call getsockopt again to verify that 
  // the socket is in listening mode.
  if (getsockopt(ListenSocket, 
    SOL_SOCKET, 
    SO_ACCEPTCONN, 
    (char*)&optVal, 
    &optLen) != SOCKET_ERROR)
    printf("SockOpt Value: %ld\n", optVal);

  WSACleanup();
  return;
}

Hinweise zu IrDA-Sockets

Die Af_irda.h-Headerdatei muss explizit enthalten sein.
Windows gibt WSAENETDOWN zurück, um anzugeben, dass der zugrunde liegende Transceivertreiber nicht mit dem IrDA-Protokollstapel initialisiert werden konnte.
IrDA unterstützt mehrere spezielle Socketoptionen:

Wert Typ Bedeutung

IRLMP_ENUMDEVICES *DEVICELIST Beschreibt Geräte im Bereich.

IRLMP_IAS_QUERY *IAS_QUERY Abrufen von IAS-Attributen.

Wert	Typ	Bedeutung
IRLMP_ENUMDEVICES	*DEVICELIST	Beschreibt Geräte im Bereich.
IRLMP_IAS_QUERY	*IAS_QUERY	Abrufen von IAS-Attributen.

Bevor eine IrDA-Socketverbindung initiiert werden kann, muss eine Geräteadresse abgerufen werden, indem ein getsockopt(,,IRLMP_ENUMDEVICES,,)-Funktionsaufruf ausgeführt wird, der eine Liste aller verfügbaren IrDA-Geräte zurückgibt. Eine vom Funktionsaufruf zurückgegebene Geräteadresse wird in eine SOCKADDR_IRDA-Struktur kopiert, die wiederum von einem nachfolgenden Aufruf des Verbindungsfunktionsaufrufs verwendet wird.

Die Ermittlung kann auf zwei Arten durchgeführt werden:

Erstens führt die Ausführung eines getockopt-Funktionsaufrufs mit der Option IRLMP_ENUMDEVICES dazu, dass eine einzelne Ermittlung auf jedem Adapter im Leerlauf ausgeführt wird. Die Liste der ermittelten Geräte und zwischengespeicherten Geräte (auf aktiven Adaptern) wird sofort zurückgegeben.

Der folgende Code veranschaulicht diesen Ansatz.

#include <winsock2.h>
#include <ws2tcpip.h>
#include <af_irda.h>
#include <stdio.h>
#include <windows.h>

// link with Ws2_32.lib

int __cdecl main()
{

    //-----------------------------------------
    // Declare and initialize variables
    WSADATA wsaData;

    int iResult;
    int i;
    DWORD dwError;

    SOCKET Sock = INVALID_SOCKET;

#define DEVICE_LIST_LEN    10


    SOCKADDR_IRDA DestSockAddr = { AF_IRDA, 0, 0, 0, 0, "SampleIrDAService" };

    unsigned char DevListBuff[sizeof (DEVICELIST) -
                              sizeof (IRDA_DEVICE_INFO) +
                              (sizeof (IRDA_DEVICE_INFO) * DEVICE_LIST_LEN)];

    int DevListLen = sizeof (DevListBuff);
    PDEVICELIST pDevList;

    pDevList = (PDEVICELIST) & DevListBuff;

    // Initialize Winsock
    iResult = WSAStartup(MAKEWORD(2, 2), &wsaData);
    if (iResult != 0) {
        printf("WSAStartup failed: %d\n", iResult);
        return 1;
    }

    Sock = socket(AF_IRDA, SOCK_STREAM, 0);
    if (Sock == INVALID_SOCKET) {
        dwError = WSAGetLastError();
        printf
            ("socket failed trying to create an AF_IRDA socket with error %d\n",
             dwError);

        if (dwError == WSAEAFNOSUPPORT) {
            printf("Check that the local computer has an infrared device\n");
            printf
                ("and a device driver is installed for the infrared device\n");
        }
        WSACleanup();
        return 1;
    }
    // Sock is not in connected state
    iResult = getsockopt(Sock, SOL_IRLMP, IRLMP_ENUMDEVICES,
                         (char *) pDevList, &DevListLen);
    if (iResult == SOCKET_ERROR) {
        printf("getsockopt failed with error %d\n", WSAGetLastError());
        WSACleanup();
        return 1;
    }

    if (pDevList->numDevice == 0) {
        // no devices discovered or cached
        // not a bad idea to run a couple of times
        printf("No IRDA devices were discovered or cached\n");
    } else {
        // one per discovered device
        for (i = 0; i < (int) pDevList->numDevice; i++) {
            // typedef struct _IRDA_DEVICE_INFO
            // {
            //     u_char    irdaDeviceID[4];
            //     char      irdaDeviceName[22];
            //     u_char    irdaDeviceHints1;
            //     u_char    irdaDeviceHints2;
            //     u_char    irdaCharSet;
            // } _IRDA_DEVICE_INFO;

            // pDevList->Device[i]. see _IRDA_DEVICE_INFO for fields
            // display the device names and let the user select one
        }
    }

    // assume the user selected the first device [0]
    memcpy(&DestSockAddr.irdaDeviceID[0], &pDevList->Device[0].irdaDeviceID[0],
           4);

    iResult = connect(Sock, (const struct sockaddr *) &DestSockAddr,
                      sizeof (SOCKADDR_IRDA));
    if (iResult == SOCKET_ERROR) {
        printf("connect failed with error %d\n", WSAGetLastError());
    } else
        printf("connect to first IRDA device was successful\n");

    WSACleanup();
    return 0;
}

Der zweite Ansatz für die Ermittlung von IrDA-Geräteadressen besteht darin, eine verzögerte Ermittlung durchzuführen. bei diesem Ansatz wird die Anwendung erst benachrichtigt, wenn sich die Liste der ermittelten Geräte gegenüber der letzten Ermittlung ändert, die vom Stapel ausgeführt wurde.

Die devicelist-Struktur , die in der Spalte Typ in der vorherigen Tabelle angezeigt wird, ist ein erweiterbares Array von Gerätebeschreibungen. IrDA füllt so viele Gerätebeschreibungen ein, wie in den angegebenen Puffer passen können. Die Gerätebeschreibung besteht aus einem Gerätebezeichner, der zum Bilden einer sockaddr_irda-Struktur erforderlich ist, und einer anzeigebaren Zeichenfolge, die das Gerät beschreibt.

Die IAS_QUERY-Struktur , die in der Spalte Typ in der vorherigen Tabelle angezeigt wird, wird verwendet, um ein einzelnes Attribut einer einzelnen Klasse aus der IAS-Datenbank eines Peergeräts abzurufen. Die Anwendung gibt das abzufragende Gerät und die Klasse sowie das Attribut und den Attributtyp an. Beachten Sie, dass das Gerät zuvor durch einen Aufruf von getsockopt(IRLMP_ENUMDEVICES) abgerufen worden wäre. Es wird erwartet, dass die Anwendung einen Puffer der erforderlichen Größe für die zurückgegebenen Parameter zuweist.

Viele Ebenen-Socketoptionen sind für IrDA nicht sinnvoll; nur SO_LINGER und SO_DONTLINGER werden speziell unterstützt.

Windows Phone 8: Diese Funktion wird für Windows Phone Store-Apps ab Windows Phone 8 unterstützt.

Windows 8.1 und Windows Server 2012 R2: Diese Funktion wird für Windows Store-Apps auf Windows 8.1, Windows Server 2012 R2 und höher unterstützt.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows 8.1, Windows Vista [Desktop-Apps \| UWP-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2003 [Desktop-Apps \| UWP-Apps]
Zielplattform	Windows
Kopfzeile	winsock.h (Winsock2.h einschließen)
Bibliothek	Ws2_32.lib
DLL	Ws2_32.dll