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 |
|---|---|
| Fehler beim Netzwerksubsystem. | |
| Der Deskriptor ist kein Socket. | |
| Das lpQOS-Argument ist kein gültiger Teil des Benutzeradressraums, oder die Pufferlänge für lpQOS ist zu klein. | |
| 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 |