WSCInstallQOSTemplate-Funktion (ws2spi.h)
[ 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 |
|---|---|
| Mindestens eins der Argumente befindet sich nicht in einem gültigen Teil des Benutzeradressraums. | |
| 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. | |
| Speicher kann nicht für Puffer zugewiesen werden. | |
| 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. | |
| Ein Systemaufruf, der niemals fehlschlagen sollte, ist fehlgeschlagen. | |
| 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 |