Platform SDK: Quality of Service

WSCRemoveQOSTemplate

The WSCRemoveQOSTemplate function removes a QOS template. Note that the caller of this function must have administrative rights.

BOOL WSCRemoveQOSTemplate ( 
  const LPGUID lpProviderId, 
  LPWSABUF lpQOSName
);

Parameters

lpProviderId: [in] Pointer to a provider-selected globally unique identifier (GUID).
lpQOSName: [in] Specifies the QOS template name.

Return Values

If WSCRemoveQOSTemplate succeeds, the return value is TRUE. If the function fails, the return value is FALSE. For extended error information, call WSAGetLastError.

Remarks

The WSCRemoveQOSTemplate function deletes a QOS template previously installed with WSCInstallQOSTemplate. If lpProviderId is NULL, WSCRemoveQOSTemplate attempts to find and delete a QOS template from the global list of QOS names. Otherwise, WSCRemoveQOSTemplate attempts to find and delete a QOS template specific to the service provider associated with lpProviderId. You cannot delete the base set of QOS names included with Windows Sockets 2. The WSAEINVAL error code will be returned if such an attempt is made.

Error Codes

Error Code	Meaning
WSAEINVAL	The specified QOS template name is invalid.
WSA_NODATA	The specified QOS template could not be found.
WSEFAULT	One or more of the parameters is not a valid part of the user address space.

Requirements