WSCInstallQOSTemplate-Funktion (ws2spi.h)

Artikel
08/28/2023

[ Diese Funktion wird in Windows Vista und nachfolgenden Versionen des Betriebssystems nicht unterstützt.]

Die WSCInstallQOSTemplate-Funktion installiert die angegebene QoS-Vorlage in der Systemkonfigurationsdatenbank.

Syntax

int WSCInstallQOSTemplate(
  [in] const LPGUID Guid,
  [in] LPWSABUF     QosName,
  [in] LPQOS        Qos
);

Parameter

[in] Guid

Der globally unique Identifier (GUID) für den QoS-Anbieter (Quality of Service).

[in] QosName

Ein Zeiger auf eine WSABUF-Struktur , die den QoS-Namen der zu installierenden Vorlage enthält.

[in] Qos

Ein Zeiger auf eine QOS-Struktur , die die Qualität der Dienstflussspezifikationen und alle anbieterspezifischen Informationen für die QoS-Vorlage angibt.

Rückgabewert

Wenn die WSCInstallQOSTemplate-Funktion erfolgreich ist, ist der Rückgabewert 0. Andernfalls wird einer der folgenden Fehlercodes zurückgegeben.

Fehlercode	Bedeutung
WSAEFAULT	Mindestens eins der Argumente befindet sich nicht in einem gültigen Teil des Benutzeradressraums.
WSAEINVAL	Mindestens ein Argument ist ungültig. Dieser Fehler wird zurückgegeben, wenn der im Guid-Parameter angegebene QoS-Anbieter ungültig oder der im QosName-Parameter angegebene QoS-Vorlagenname ungültig ist. Dieser Fehler wird auch zurückgegeben, wenn der Inhalt der im Qos-Parameter angegebenen Vorlagenstruktur ungültig oder unvollständig ist.
WSAENOBUFS	Speicher kann nicht für Puffer zugewiesen werden.
WSANO_RECOVERY	Ein nicht behebbarer Fehler ist aufgetreten. Dieser Fehler wird unter verschiedenen Bedingungen zurückgegeben, einschließlich der folgenden: Der Anbieter ist bereits installiert, dem Benutzer fehlen die Administratorrechte, die zum Schreiben in die Winsock-Registrierung erforderlich sind, oder beim Erstellen oder Installieren eines Katalogeintrags ist ein Fehler aufgetreten.
WSASYSCALLFAILURE	Ein Systemaufruf, der niemals fehlschlagen sollte, ist fehlgeschlagen.
WSA_NOT_ENOUGH_MEMORY	Nicht genügend Arbeitsspeicher war verfügbar. Dieser Fehler wird zurückgegeben, wenn nicht genügend Arbeitsspeicher vorhanden ist, um einen neuen Katalogeintrag zuzuweisen.

Hinweise

Die WSCInstallQOSTemplate-Funktion wird unter Windows Vista und höher nicht unterstützt. Wenn diese Funktion unter Windows Vista aufgerufen wird und ein Fehler zurückgegeben wird.

Die WSCInstallQOSTemplate-Funktion installiert eine QoS-Vorlage basierend auf einem QoS-Namen. Der Aufrufer der WSCInstallQOSTemplate-Funktion muss über die entsprechenden Administratorrechte verfügen, damit der Aufruf erfolgreich ist.

Die QOS-Struktur , die die QoS-Einstellungen enthält, kann später abgerufen werden, indem Sie die WSPGetQOSByName-Funktion aufrufen und den zugehörigen QoS-Namen übergeben.

Die WSCInstallQOSTemplate-Funktion installiert eine benannte QoS-Vorlage, die die
QOS-Struktur , die im Qos-Parameter angegeben ist. Wenn bereits eine QoS-Vorlage mit dem im Qosname-Parameter angegebenen QoS-Namen vorhanden ist, ersetzen die im Qos-Parameter angegebenen Einstellungen die Einstellungen der vorhandenen Vorlage.

Wenn der Guid-Parameter auf NULL festgelegt ist, gilt die installierte QOS-Vorlage für alle Dienstanbieter. Wenn der Guid-Parameter nicht NULL ist, gilt die installierte QoS-Vorlage nur für den vom Guid-Parameter angegebenen Anbieter.

QoS-Vorlageneinstellungen werden im nicht flüchtigen Speicher gespeichert. Daher geben nachfolgende Aufrufe der WSAGetQOSByName-Funktion mit demselben QoS-Namen, der im lpQOSName-Parameter angegeben ist, dieselbe QOS-Struktur zurück, die an die WSCInstallQOSTemplate-Funktion übergeben wurde.

Windows Sockets 2 enthält einen Basissatz von QoS-Vorlagen. Sie können eine dieser QoS-Vorlagen überschreiben und ersetzen oder eine vorhandene QoS-Vorlage ändern, indem Sie einfach eine neue Vorlage mit dem vorhandenen Namen installieren. Sie müssen eine vorhandene Vorlage nicht löschen, bevor Sie sie ersetzen oder ändern. Sie können den Basissatz von QoS-benannten Vorlagen, die in Windows Sockets 2 enthalten sind, nicht löschen. Sie können jedoch Vorlagen löschen, die später hinzugefügt wurden, möglicherweise von anderen Dienstanbietern.

Der Qos-Parameter verweist auf eine QOS-Struktur , die einen Puffer enthalten kann, der anbieterspezifische Einstellungen im ProviderSpecific-Member der QOS-Struktur enthält. Alle anbieterspezifischen Einstellungen werden mit der grundlegenden QOS-Struktur gespeichert und in nachfolgenden Aufrufen der WSAGetQOSByName-Funktion zurückgegeben.

Das ProviderSpecific-Element der QOS-Struktur kann auch dann festgelegt werden, wenn der Guid-Parameter auf NULL festgelegt ist, um eine globale QoS-Vorlage für alle Dienstanbieter zu installieren. Beachten Sie, dass diese Vorgehensweise dazu führen kann, dass ein Dienstanbieter das ProviderSpecific-Element der QOS-Struktur ignoriert, wenn der Dienstanbieter seinen Inhalt nicht erkennt. Die empfohlene Verwendung der WSCInstallQOSTemplate-Funktion besteht darin, anbieterspezifische Einstellungen im ProviderSpecific-Member der QOS-Struktur nur dann einzubeziehen, wenn die benannte Vorlage auf einem bestimmten Dienstanbieter installiert wird (der Guid-Parameter ist nicht NULL).

Anforderungen

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

Weitere Informationen

QOS

WSABUF

WSPGetQOSByName

Share via