SecureEnvironment.Create Methode

Definition

Namespace:

System.Security.RightsManagement

Assembly:

WindowsBase.dll

Erstellt eine sichere Clientsitzung für Rights Management-Vorgänge.

Überlädt

Create(String, ContentUser)	Erstellt eine sichere Clientsitzung für einen angegebenen Benutzer mit einem angegebenen Rechtemanifest.
Create(String, AuthenticationType, UserActivationMode)	Erstellt eine sichere Clientsitzung unter Angabe von Anwendungsrechtemanifest, AuthenticationType und UserActivationMode.

Beispiele

Im folgenden Beispiel wird gezeigt, wie Sie diese Methode verwenden, um eine sichere Umgebung zu erstellen.

string applicationManifest = "<manifest></manifest>";
if (File.Exists("rpc.xml"))
{
    StreamReader manifestReader = File.OpenText("rpc.xml");
    applicationManifest = manifestReader.ReadToEnd();
}

if (_secureEnv == null)
{
    if (SecureEnvironment.IsUserActivated(new ContentUser(
                _currentUserId, AuthenticationType.Windows)))
    {
        _secureEnv = SecureEnvironment.Create(
            applicationManifest, new ContentUser(
                _currentUserId, AuthenticationType.Windows));
    }
    else
    {
        _secureEnv = SecureEnvironment.Create(
            applicationManifest,
            AuthenticationType.Windows,
            UserActivationMode.Permanent);
    }
}

Dim applicationManifest As String = "<manifest></manifest>"
If File.Exists("rpc.xml") Then
    Dim manifestReader As StreamReader = File.OpenText("rpc.xml")
    applicationManifest = manifestReader.ReadToEnd()
End If

If _secureEnv Is Nothing Then
    If SecureEnvironment.IsUserActivated(New ContentUser(_currentUserId, AuthenticationType.Windows)) Then
        _secureEnv = SecureEnvironment.Create(applicationManifest, New ContentUser(_currentUserId, AuthenticationType.Windows))
    Else
        _secureEnv = SecureEnvironment.Create(applicationManifest, AuthenticationType.Windows, UserActivationMode.Permanent)
    End If
End If

Create(String, ContentUser)

Erstellt eine sichere Clientsitzung für einen angegebenen Benutzer mit einem angegebenen Rechtemanifest.

public:
 static System::Security::RightsManagement::SecureEnvironment ^ Create(System::String ^ applicationManifest, System::Security::RightsManagement::ContentUser ^ user);

public static System.Security.RightsManagement.SecureEnvironment Create (string applicationManifest, System.Security.RightsManagement.ContentUser user);

static member Create : string * System.Security.RightsManagement.ContentUser -> System.Security.RightsManagement.SecureEnvironment

Public Shared Function Create (applicationManifest As String, user As ContentUser) As SecureEnvironment

Parameter

applicationManifest

String

Das Anwendungsrechtemanifest.

user

ContentUser

Der Benutzer oder die Benutzergruppe, dem oder der Zugriff auf durch die Rechteverwaltung geschützte Inhalte gewährt wird.

Gibt zurück

SecureEnvironment

Eine sichere Clientsitzung für die Aktivierung, Lizenzbindung und andere Rechteverwaltungsvorgänge.

Beispiele

Im folgenden Beispiel wird gezeigt, wie Sie diese Methode verwenden, um eine sichere Umgebung zu erstellen.

string applicationManifest = "<manifest></manifest>";
if (File.Exists("rpc.xml"))
{
    StreamReader manifestReader = File.OpenText("rpc.xml");
    applicationManifest = manifestReader.ReadToEnd();
}

if (_secureEnv == null)
{
    if (SecureEnvironment.IsUserActivated(new ContentUser(
                _currentUserId, AuthenticationType.Windows)))
    {
        _secureEnv = SecureEnvironment.Create(
            applicationManifest, new ContentUser(
                _currentUserId, AuthenticationType.Windows));
    }
    else
    {
        _secureEnv = SecureEnvironment.Create(
            applicationManifest,
            AuthenticationType.Windows,
            UserActivationMode.Permanent);
    }
}

Dim applicationManifest As String = "<manifest></manifest>"
If File.Exists("rpc.xml") Then
    Dim manifestReader As StreamReader = File.OpenText("rpc.xml")
    applicationManifest = manifestReader.ReadToEnd()
End If

If _secureEnv Is Nothing Then
    If SecureEnvironment.IsUserActivated(New ContentUser(_currentUserId, AuthenticationType.Windows)) Then
        _secureEnv = SecureEnvironment.Create(applicationManifest, New ContentUser(_currentUserId, AuthenticationType.Windows))
    Else
        _secureEnv = SecureEnvironment.Create(applicationManifest, AuthenticationType.Windows, UserActivationMode.Permanent)
    End If
End If

Hinweise

Diese Create Methode ist für die Verwendung mit Benutzern vorgesehen, die bereits aktiviert sind, z. B. in der von GetActivatedUsersder Liste zurückgegebenen Liste. Verwenden Sie die alternative Create Methode für Benutzer, die noch nicht aktiviert sind.

Siehe auch

• UserActivationMode

Create(String, AuthenticationType, UserActivationMode)

Erstellt eine sichere Clientsitzung unter Angabe von Anwendungsrechtemanifest, AuthenticationType und UserActivationMode.

public:
 static System::Security::RightsManagement::SecureEnvironment ^ Create(System::String ^ applicationManifest, System::Security::RightsManagement::AuthenticationType authentication, System::Security::RightsManagement::UserActivationMode userActivationMode);

public static System.Security.RightsManagement.SecureEnvironment Create (string applicationManifest, System.Security.RightsManagement.AuthenticationType authentication, System.Security.RightsManagement.UserActivationMode userActivationMode);

static member Create : string * System.Security.RightsManagement.AuthenticationType * System.Security.RightsManagement.UserActivationMode -> System.Security.RightsManagement.SecureEnvironment

Public Shared Function Create (applicationManifest As String, authentication As AuthenticationType, userActivationMode As UserActivationMode) As SecureEnvironment

Parameter

applicationManifest

String

Das Anwendungsrechtemanifest.

authentication

AuthenticationType

Die Authentifizierungsmethode.

userActivationMode

UserActivationMode

Der Typ des Benutzer-Rechtekontozertifikats.

Gibt zurück

SecureEnvironment

Eine sichere Clientsitzung für die Aktivierung, Lizenzbindung und andere Rechteverwaltungsvorgänge.

Beispiele

Im folgenden Beispiel wird gezeigt, wie Sie diese Methode verwenden, um eine sichere Umgebung zu erstellen.

string applicationManifest = "<manifest></manifest>";
if (File.Exists("rpc.xml"))
{
    StreamReader manifestReader = File.OpenText("rpc.xml");
    applicationManifest = manifestReader.ReadToEnd();
}

if (_secureEnv == null)
{
    if (SecureEnvironment.IsUserActivated(new ContentUser(
                _currentUserId, AuthenticationType.Windows)))
    {
        _secureEnv = SecureEnvironment.Create(
            applicationManifest, new ContentUser(
                _currentUserId, AuthenticationType.Windows));
    }
    else
    {
        _secureEnv = SecureEnvironment.Create(
            applicationManifest,
            AuthenticationType.Windows,
            UserActivationMode.Permanent);
    }
}

Dim applicationManifest As String = "<manifest></manifest>"
If File.Exists("rpc.xml") Then
    Dim manifestReader As StreamReader = File.OpenText("rpc.xml")
    applicationManifest = manifestReader.ReadToEnd()
End If

If _secureEnv Is Nothing Then
    If SecureEnvironment.IsUserActivated(New ContentUser(_currentUserId, AuthenticationType.Windows)) Then
        _secureEnv = SecureEnvironment.Create(applicationManifest, New ContentUser(_currentUserId, AuthenticationType.Windows))
    Else
        _secureEnv = SecureEnvironment.Create(applicationManifest, AuthenticationType.Windows, UserActivationMode.Permanent)
    End If
End If

Hinweise

Diese Create Methode ist für neue Benutzer vorgesehen, die noch nicht aktiviert sind.

Die Aktivierung eines neuen Benutzers umfasst eine Roundtrip-Servertransaktion zum Abrufen des Benutzerzertifikats und des Clientlizenzzertifikats.

Die alternative Create Methode kann verwendet werden, wenn ein Benutzer bereits aktiviert ist, z. B. in der von der Liste zurückgegebenen GetActivatedUsersListe.