ReplicationServer.ChangeDistributorPassword Method (SecureString)

Changes the Distributor password, where the new password is supplied as a SecureString object.

Namespace: Microsoft.SqlServer.Replication
Assembly: Microsoft.SqlServer.Rmo (in microsoft.sqlserver.rmo.dll)

Syntax

'Declaration
Public Sub ChangeDistributorPassword ( _
    password As SecureString _
)

public void ChangeDistributorPassword (
    SecureString password
)

public:
void ChangeDistributorPassword (
    SecureString^ password
)

public void ChangeDistributorPassword (
    SecureString password
)

public function ChangeDistributorPassword (
    password : SecureString
)

Parameters

• password
  The new Distributor password is a SecureString value.

  Security Note:
  When possible, prompt users to enter security credentials at run time. If you must store credentials, use the cryptographic services provided by the Windows .NET Framework.

Remarks

The DistributorInstalled property must be true to set this property.

The ChangeDistributorPassword(SecureString) method provides additional security for the password while it is stored in memory and should be used instead of ChangeDistributorPassword(String).

The ChangeDistributorPassword method can be called by members of the sysadmin fixed server role at the Distributor.

The ChangeDistributorPassword method is equivalent to the sp_changedistributor_password (Transact-SQL) stored procedure.

This namespace, class, or member is supported only in version 2.0 of the .NET Framework.

Thread Safety

Any public static (Shared in Microsoft Visual Basic) members of this type are thread safe. Any instance members are not guaranteed to be thread safe.

Platforms

Development Platforms

For a list of the supported platforms, see Hardware and Software Requirements for Installing SQL Server 2005.

Target Platforms

For a list of the supported platforms, see Hardware and Software Requirements for Installing SQL Server 2005.

See Also

Reference

ReplicationServer Class
ReplicationServer Members
Microsoft.SqlServer.Replication Namespace