RatingEnable Function

---

Enables or disables ratings.

Syntax

HRESULT RatingEnable(
     HWND hwndParent, 
     LPCSTR pszUsername, 
     BOOL fEnable
);

Parameters

hwndParent

Handle to a parent window used for any dialog boxes that might be presented.

pszUsername

Address of a string that contains the name of the user requesting ratings to be enabled or disabled.

fEnable

Boolean value that specifies whether ratings should be enabled or disabled. TRUE indicates that ratings should be enabled, and FALSE indicates they should be disabled.

Return Value

Returns one of the following values:
 

S_OK	If fEnable was TRUE, ratings have been enabled. Otherwise, ratings were disabled.
S_FALSE	Ratings were not successfully enabled or disabled.
E_ACCESSDENIED	Ratings were enabled, and the user specified a bad password.
HRESULT_FROM_WIN32(ERROR_BAD_USERNAME)	The specified user name was invalid.

Function Information

Windows NT	Use version 4.0
Windows	Use Windows 95 and later
Header	Ratings.h
Import Library	Msrating.lib
Minimum availability	Internet Explorer 4.0