Funzione WSCInstallQOSTemplate (ws2spi.h)
[ Questa funzione non è supportata in Windows Vista e nelle versioni successive del sistema operativo.]
La funzione WSCInstallQOSTemplate installa il modello QoS specificato nel database di configurazione del sistema.
Sintassi
int WSCInstallQOSTemplate(
[in] const LPGUID Guid,
[in] LPWSABUF QosName,
[in] LPQOS Qos
);
Parametri
[in] Guid
Identificatore univoco globale (GUID) per il provider QoS (Quality of Service).
[in] QosName
Puntatore a una struttura WSABUF contenente il nome QoS del modello da installare.
[in] Qos
Puntatore a una struttura QOS che specifica la qualità delle specifiche del flusso di servizio e le informazioni specifiche del provider per il modello QoS.
Valore restituito
Se la funzione WSCInstallQOSTemplate ha esito positivo, il valore restituito è zero. In caso contrario, restituisce uno dei codici di errore seguenti.
| Codice di errore | Significato |
|---|---|
| Uno o più argomenti non si trovano in una parte valida dello spazio indirizzi utente. | |
| Uno o più argomenti non sono validi. Questo errore viene restituito se il provider QoS specificato nel parametro Guid non è valido o il nome del modello QoS specificato nel parametro QosName non è valido. Questo errore viene restituito anche se il contenuto della struttura del modello specificato nel parametro Qos non è valido o incompleto. | |
| La memoria non può essere allocata per i buffer. | |
| Si è verificato un errore irreversibile. Questo errore viene restituito in diverse condizioni, tra cui quanto segue: il provider è già installato, l'utente non dispone dei privilegi amministrativi necessari per scrivere nel Registro di sistema Winsock o si è verificato un errore durante la creazione o l'installazione di una voce del catalogo. | |
| Chiamata di sistema che non dovrebbe mai avere esito negativo. | |
| Memoria insufficiente disponibile. Questo errore viene restituito quando la memoria non è sufficiente per allocare una nuova voce del catalogo. |
Commenti
La funzione WSCInstallQOSTemplate non è supportata in Windows Vista e versioni successive. Se questa funzione viene chiamata in Windows Vista e viene restituito l'errore.
La funzione WSCInstallQOSTemplate installa un modello QoS, in base a un nome QoS. Il chiamante della funzione WSCInstallQOSTemplate deve disporre dei diritti amministrativi appropriati affinché la chiamata abbia esito positivo.
La struttura QOS che contiene le impostazioni QoS può essere recuperata in un secondo momento chiamando la funzione WSPGetQOSByName e passando il nome QoS associato.
La funzione WSCInstallQOSTemplate installa un modello QoS denominato che contiene l'oggetto
Struttura QOS specificata nel parametro Qos. Se esiste già un modello QoS con il nome QoS specificato nel parametro Qosname , le impostazioni specificate nel parametro Qos sostituiscono le impostazioni del modello esistente.
Se il parametro Guid è impostato su NULL, il modello QOS installato si applica a tutti i provider di servizi. Se il parametro Guid non è NULL, il modello QoS installato si applica solo al provider indicato dal parametro Guid .
Le impostazioni del modello QoS vengono archiviate nell'archiviazione non volatile, quindi le chiamate successive alla funzione WSAGetQOSByName con lo stesso nome QoS specificato nel parametro lpQOSName , restituiscono la stessa struttura QOS passata alla funzione WSCInstallQOSTemplate .
Windows Sockets 2 include un set di base di modelli QoS. È possibile eseguire l'override e sostituire uno di questi modelli QoS o modificare un modello QoS esistente installando semplicemente un nuovo modello con il nome esistente. Non è necessario eliminare un modello esistente prima di sostituirlo o modificarlo. Non è possibile eliminare il set di base di modelli denominati QoS inclusi in Windows Sockets 2. Tuttavia, è possibile eliminare i modelli aggiunti successivamente, ad esempio da altri provider di servizi.
Il parametro Qos punta a una struttura QOS che può includere un buffer che contiene impostazioni specifiche del provider nel membro ProviderSpecific della struttura QOS . Tutte le impostazioni specifiche del provider vengono archiviate con la struttura QOS di base e vengono restituite nelle chiamate successive alla funzione WSAGetQOSByName .
Il membro ProviderSpecific della struttura QOS può essere impostato anche se il parametro Guid è impostato su NULL per installare un modello QoS globale per tutti i provider di servizi. Si noti che questa procedura può portare un provider di servizi a ignorare il membro ProviderSpecifico della struttura QOS se il provider di servizi non riconosce il relativo contenuto. L'uso consigliato della funzione WSCInstallQOSTemplate consiste nell'includere le impostazioni specifiche del provider nel membro ProviderSpecific della struttura QOS solo se il modello denominato viene installato in un provider di servizi specifico (il parametro Guid non è NULL).
Requisiti
| Requisito | Valore |
|---|---|
| Client minimo supportato | Windows 2000 Professional [solo app desktop] |
| Server minimo supportato | Windows 2000 Server [solo app desktop] |
| Piattaforma di destinazione | Windows |
| Intestazione | ws2spi.h |