RestoreEncryptionKey Method (WMI MSReportServer_ConfigurationSetting)

Reapplies the specified encryption key to the report server database.

Syntax

Public Sub RestoreEncryptionKey(ByRef KeyFile() As Integer, _
    ByRef Length As Int32, ByVal Password As String, _
    ByRef HRESULT As Int32, ByRef ExtendedErrors() As String)
public void RestoreEncryptionKey(out Byte[] KeyFile, out Int32 Length, 
            string Password, out Int32 HRESULT, out string[] ExtendedErrors);

Parameters

  • KeyFile[]
    [out] An array containing the encrypted encryption key.

  • Length
    [out] The length of the array returned by the method.

  • Password
    A string used to encrypt the encryption key.

  • 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

If an entry already exists for the report server in the report server database, it is deleted. The new entry is then created using the specified encryption key and the report server’s public key.

The method is most effective when called after the DeleteEncryptionKey method, which clears the list of encryption keys.

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)