RatingEnable function

Note  The Internet Ratings API is deprecated, and will be removed in a future release. Use Windows 8 Family Safety feature instead.
 

Enables or disables ratings.

Syntax

C++
Copy 

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

Parameters

hwndParent

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

pszUsername

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

fEnable

A BOOLvalue 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. 

Return codeDescription
S_OK

If fEnable was TRUE, ratings are enabled. Otherwise, ratings were disabled.

S_FALSE

Ratings are not successfully enabled or disabled.

E_ACCESSDENIED

Ratings are enabled, and the user specified a bad password.

HRESULT_FROM_WIN32(ERROR_BAD_USERNAME)

The specified user name was invalid.

 

Requirements

Minimum supported client

Windows XP

Minimum supported server

Windows 2000 Server

Product

Internet Explorer 4.0

Header
Ratings.h

Library
Msrating.lib

DLL
Msrating.dll

Unicode and ANSI names

RatingEnableW (Unicode) and RatingEnable (ANSI)

 

 

Show: