SecureEnvironment.Create Metodo

Definizione

Spazio dei nomi:

System.Security.RightsManagement

Assembly:

WindowsBase.dll

Crea una sessione client protetta per le operazioni di gestione dei diritti.

Overload

Create(String, ContentUser)	Crea una sessione client protetta per un utente specificato con un manifesto di diritti specificato.
Create(String, AuthenticationType, UserActivationMode)	Crea una sessione client sicura dati un manifesto di diritti dell'applicazione, un oggetto AuthenticationType e un oggetto UserActivationMode.

Esempio

Nell'esempio seguente viene illustrato come usare questo metodo per creare un ambiente sicuro.

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)

Crea una sessione client protetta per un utente specificato con un manifesto di diritti specificato.

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

Parametri

applicationManifest

String

Manifesto di diritti dell'applicazione.

user

ContentUser

Utente o gruppo di utenti a cui concedere l'accesso a contenuto protetto da Rights Management.

Restituisce

SecureEnvironment

Sessione client sicura per l'attivazione, l'associazione delle licenze e altre operazioni Rights Management.

Esempio

Nell'esempio seguente viene illustrato come usare questo metodo per creare un ambiente sicuro.

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

Commenti

Questo Create metodo è destinato all'uso con gli utenti già attivati, ad esempio forniti nell'elenco restituito da GetActivatedUsers. Usare il metodo alternativo Create per gli utenti che non sono ancora attivati.

Vedi anche

• UserActivationMode

Create(String, AuthenticationType, UserActivationMode)

Crea una sessione client sicura dati un manifesto di diritti dell'applicazione, un oggetto AuthenticationType e un oggetto 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

Parametri

applicationManifest

String

Manifesto di diritti dell'applicazione.

authentication

AuthenticationType

Metodo di autenticazione.

userActivationMode

UserActivationMode

Tipo di certificato dell'account con diritti utente.

Restituisce

SecureEnvironment

Sessione client sicura per l'attivazione, l'associazione delle licenze e altre operazioni Rights Management.

Esempio

Nell'esempio seguente viene illustrato come usare questo metodo per creare un ambiente sicuro.

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

Commenti

Questo Create metodo è destinato a nuovi utenti che non sono ancora attivati.

L'attivazione di un nuovo utente include una transazione del server di andata e ritorno per ottenere il certificato utente e il certificato di licenza client.

Il metodo alternativo Create può essere usato se un utente è già attivato, ad esempio fornito nell'elenco restituito da GetActivatedUsers.