ReportingService2010.LogonUser(String, String, String) 方法
定义
重要
一些信息与预发行产品相关,相应产品在发行之前可能会进行重大修改。 对于此处提供的信息,Microsoft 不作任何明示或暗示的担保。
使用户登录,然后验证对报表服务器 Web 服务的用户请求。 此方法仅适用于本机模式。
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);
[<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)>]
member this.LogonUser : string * string * string -> unit
Public Sub LogonUser (userName As String, password As String, authority As String)
参数
- userName
- String
用户的名称。
- password
- String
用户的密码。
- authority
- String
(可选)对用户进行身份验证时使用的域名。 传递值 null
(在 Visual Basic 中为 Nothing
)可忽略此参数。
- 属性
注解
下表显示了有关此操作的标头和权限信息。
SOAP 标头用法 | (In) TrustedUserHeaderValue (Out) ServerInfoHeaderValue |
本机模式所需的权限 | 无 |
SharePoint 模式所需权限 | 不支持 |
此方法在 OperationNotSupportedSharePointMode
SharePoint 模式下调用时引发异常。
配置自定义身份验证后,此方法向报表服务器 Web 服务对指定用户进行身份验证。
必须通过安全套接字层 (SSL) 调用此方法。 如果未安全调用方法,则该方法将失败。 身份验证成功后,报表服务器 Web 服务将生成身份验证 Cookie,并在 HTTPS 标头中返回该 Cookie。 响应通过 SSL 返回。