RatingAccessDeniedDialog 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 telling the user that access to the requested content is denied.

Syntax

C++


HRESULT RatingAccessDeniedDialog(
   HWND    hDlg,
   LPCTSTR pszUsername,
   LPCTSTR pszContentDescription,
   VOID    *pRatingDetails
);

Parameters

hDlg: A handle to the modal dialog box.
pszUsername: The address of a string that contains the name of the user who was denied access. If this parameter is NULL, the user name is extracted from the structure specified by pRatingDetails, or the current user name is used.
pszContentDescription: The address of a string that describes the content to which access was denied.
pRatingDetails: The address returned by the RatingCheckUserAccess function. This parameter can provide the dialog box with additional information about why access was denied, such as whether the site is considered rated, which ratings exceeded limits, and where the ratings were obtained.

Return value

Returns one of the following values.

Return code	Description
S_OK	The site administrator entered the password. Access should be allowed.
S_FALSE	The user is still denied access to the content.
Error codes	An error occurred.

Remarks

The site administrator can set an option that adds controls to the dialog box. These controls enable a supervisor to enter a user name and password to override the rating and allow access.

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	RatingAccessDeniedDialogW (Unicode) and RatingAccessDeniedDialog (ANSI)