ReportingService2010.LogonUser(String, String, String) ReportingService2010.LogonUser(String, String, String) ReportingService2010.LogonUser(String, String, String) Method

定义

使用户登录,然后验证对报表服务器 Web 服务的用户请求。 Logs on a user and authenticates a user request to the Report Server Web service. 此方法仅适用于本机模式。 This method only applies to native mode.

public:
 void LogonUser(System::String ^ userName, System::String ^ password, System::String ^ authority);
[System.Web.Services.Protocols.SoapDocumentMethod("http://schemas.microsoft.com/sqlserver/reporting/2010/03/01/ReportServer/LogonUser", ParameterStyle=System.Web.Services.Protocols.SoapParameterStyle.Wrapped, RequestNamespace="http://schemas.microsoft.com/sqlserver/reporting/2010/03/01/ReportServer", ResponseNamespace="http://schemas.microsoft.com/sqlserver/reporting/2010/03/01/ReportServer", Use=System.Web.Services.Description.SoapBindingUse.Literal)]
[System.Web.Services.Protocols.SoapHeader("TrustedUserHeaderValue")]
[System.Web.Services.Protocols.SoapHeader("ServerInfoHeaderValue", Direction=System.Web.Services.Protocols.SoapHeaderDirection.Out)]
public void LogonUser (string userName, string password, string authority);
Public Sub LogonUser (userName As String, password As String, authority As String)
参数
userName
String String String

用户的名称。 The name of the user.

password
String String String

用户的密码。 The password of the user.

authority
String String String

(可选)对用户进行身份验证时使用的域名。 Optional.The domain name to use when authenticating a user. 传递的值null(Nothing在 Visual Basic 中) 以忽略此参数。 Pass a value of null (Nothing in Visual Basic) to omit this argument.

注解

下表显示了有关此操作的标头和权限信息。The table below shows header and permissions information on this operation.

SOAP 标头使用情况SOAP Header Usage (In) TrustedUserHeaderValue(In) TrustedUserHeaderValue

(Out) ServerInfoHeaderValue(Out) ServerInfoHeaderValue
纯模式所需的权限Native Mode Required Permissions InclusionThresholdSettingNone
SharePoint 模式所需的权限SharePoint Mode Required Permissions 不支持Not supported

此方法将引发OperationNotSupportedSharePointMode异常时在 SharePoint 模式下调用。This method throws an OperationNotSupportedSharePointMode exception when invoked in SharePoint mode.

配置自定义身份验证后,此方法对报表服务器 Web 服务指定的用户进行身份验证。This method authenticates the specified user to the Report Server Web service when custom authentication has been configured.

通过安全套接字层 (SSL),必须调用此方法。This method must be called over Secure Sockets Layer (SSL). 如果它不安全地调用,该方法将失败。The method fails if it is not called securely. 成功进行身份验证,报表服务器 Web 服务生成的身份验证 cookie,并将 cookie 返回 HTTPS 标头中。Upon successful authentication, the Report Server Web service generates an authentication cookie and returns the cookie in the HTTPS header. 通过 SSL 返回的响应。The response is returned over SSL.

适用于