Click to return to the Security     
Internet Ratings API Func...     RatingAccessDeniedDialog2...     Internet Ratings API Func...    
Web Workshop  |  Security & Cryptography

RatingAccessDeniedDialog Function


Displays a modal dialog box telling the user that access to the requested content is denied.

Syntax

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

Parameters

hDlg
Handle to the modal dialog box.
pszUsername
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
Address of a string that describes the content to which access was denied.
pRatingDetails
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:
 
S_OKThe site administrator entered the password. Access should be allowed.
S_FALSEThe user is still denied access to the content.
Error codesAn error occurred.

Remarks

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

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

See Also

RatingCheckUserAccess



Back to topBack to top

Did you find this topic useful? Suggestions for other topics? Write us!

© 1999 Microsoft Corporation. All rights reserved. Terms of use.