InitializeReportServer Method (WMI MSReportServer_ConfigurationSetting)

Initializes the specified report service instance.

Syntax

Public Sub InitializeReportServer(ByVal InstallationID As String, _
    ByRef HRESULT As Int32, ByRef ExtendedErrors() As String)
public void InitializeReportServer(string InstallationID, 
    out Int32 HRESULT, out string[] ExtendedErrors);

Parameters

  • InstallationID
    A string used to encrypt the encryption key before it is returned.

  • HRESULT
    [out] Value indicating whether the call succeeded or failed.

  • ExtendedErrors[]
    [out] A string array containing additional errors returned by the call.

Return Value

Returns an HRESULT indicating success or failure of the method call. A value of 0 indicates that the method call was successful. A non-zero value indicates that an error has occurred.

Remarks

When this method is called, the encryption key that accesses the report server database secure information is encrypted using the public key of the report server identified by InstallationID.

The specified report server’s public key must have previously been written into the report server database.

The InitializeReportServer method must be called against a report server that already has access to the secure information so that it can decrypt the encryption key. The resulting encrypted encryption key is then stored in the report server database.

If the report server’s IsInitialized property is set to true when the InitializeReportServer method is called, the method returns success without trying to encrypt the encryption key.

Requirements

Namespace: root\Microsoft\SqlServer\ReportServer\RS_<EncodedInstanceName>\v10\Admin

Platform: Windows Server 2003, Datacenter Edition; Windows Server 2003, Enterprise Edition; Windows Server 2003, Standard Edition; Windows Vista; Windows XP Professional with Service Pack 2 (SP2) or Service Pack 1 (SP1); or Windows 2000 (all versions)