RatingSetupUI function

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

 

Displays a modal dialog box that enables a parent to set levels of restrictions.

Syntax

HRESULT RatingSetupUI(
   HWND   hDlg,
   LPCSTR pszUsername
);

Parameters

  • hDlg
    A handle to the modal dialog box.

  • pszUsername
    The address of a string that contains the name of the user whose settings should be configured. If this parameter is NULL, settings for all users are configured. This parameter must be NULL in Internet Explorer 3.0.

Return value

Returns S_OK if successful, or an error value otherwise.

Remarks

This function ensures that the current user is a supervisor before allowing access to the configuration user interface.

The RatingCheckUserAccess function uses the settings supplied by this function to compare against rating labels.

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

RatingSetupUIW (Unicode) and RatingSetupUI (ANSI)