Freigeben über


LPWSPGETQOSBYNAME-Rückruffunktion (ws2spi.h)

Die WSPGetQOSByName-Funktion initialisiert eine QOS-Struktur basierend auf einer benannten Vorlage oder ruft eine Enumeration der verfügbaren Vorlagennamen ab.

Syntax

LPWSPGETQOSBYNAME Lpwspgetqosbyname;

BOOL Lpwspgetqosbyname(
  [in]      SOCKET s,
  [in, out] LPWSABUF lpQOSName,
  [out]     LPQOS lpQOS,
  [out]     LPINT lpErrno
)
{...}

Parameter

[in] s

Deskriptor, der einen Socket identifiziert.

[in, out] lpQOSName

Gibt den QOS-Vorlagennamen an oder stellt einen Puffer bereit, um eine Enumeration der verfügbaren Vorlagennamen abzurufen.

[out] lpQOS

Zeiger auf die zu füllende QOS-Struktur .

[out] lpErrno

Zeiger auf den Fehlercode.

Rückgabewert

Wenn die Funktion erfolgreich ist, ist der Rückgabewert TRUE. Wenn die Funktion fehlschlägt, ist der Rückgabewert FALSE, und ein bestimmter Fehlercode ist in lpErrno verfügbar.

Fehlercode Bedeutung
WSAENETDOWN
Fehler beim Netzwerksubsystem.
WSAENOTSOCK
Der Deskriptor ist kein Socket.
WSAENOTSOCK
Das lpQOS-Argument ist kein gültiger Teil des Benutzeradressraums, oder die Pufferlänge für lpQOS ist zu klein.
WSAEINVAL
Der angegebene QOS-Vorlagenname ist ungültig.

Hinweise

Clients können WSPGetQOSByName verwenden, um eine QOS-Struktur mit einem Satz bekannter Werte zu initialisieren, die für eine bestimmte Dienstklasse oder einen bestimmten Medientyp geeignet sind. Diese Werte werden in einer Vorlage gespeichert, auf die mit einem bekannten Namen verwiesen wird. Der Client kann diese Werte abrufen, indem er den durch lpQOSName angegebenen buf-Member des WSABUF so festlegt, dass er auf eine Unicode-Zeichenfolge ungleich null länge verweist, die einen Vorlagennamen angibt. In diesem Fall ist die Verwendung von lpQOSName nur IN, und die Ergebnisse werden über lpQOS zurückgegeben.

Alternativ kann der Client LPWSPGetQOSByName verwenden, um eine Enumeration der verfügbaren Vorlagennamen abzurufen. Der Client kann dies tun, indem er den durch lpQOSName angegebenen buf-Member des WSABUF auf eine Unicode-Zeichenfolge der Länge null festlegt. In diesem Fall wird der durch buf angegebene Puffer mit einer Sequenz von so vielen Zeichenfolgen mit namen mit NULL-Terminen versehenen Unicode-Vorlagen überschrieben, die bis zur Anzahl der in buf verfügbaren Bytes verfügbar sind, wie durch den len-Member des WSABUF angegeben durch lpQOSName angegeben. Die Liste der Namen selbst wird durch eine Unicode-Namenszeichenfolge der Länge Null beendet. Wenn LPWSPGetQOSByName zum Abrufen von Vorlagennamen verwendet wird, wird der lpQOS-Parameter ignoriert.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Windows 2000 Professional [nur Desktop-Apps]
Unterstützte Mindestversion (Server) Windows 2000 Server [nur Desktop-Apps]
Kopfzeile ws2spi.h

Weitere Informationen

LPWSPAccept

LPWSPConnect

LPWSPGetSockopt