Export (0) Print
Expand All

RatingAccessDeniedDialog2 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. This function is identical to RatingAccessDeniedDialog except that if a ratings modal dialog box is already being displayed, the details from the second call are inserted into the existing dialog box.

Syntax


HRESULT RatingAccessDeniedDialog2(
  HWND hDlg,
  LPCSTR pszUsername,
  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.

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 codeDescription
S_OK

The supervisor entered the password. Access should be allowed.

S_FALSE

The user is still denied access to the content.

Error codes

An error occurred.

 

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

RatingAccessDeniedDialog2W (Unicode) and RatingAccessDeniedDialog2 (ANSI)

See also

RatingCheckUserAccess

 

 

Show:
© 2014 Microsoft