SecureEnvironment.Create Méthode

Définition

Espace de noms:

System.Security.RightsManagement

Assembly:

WindowsBase.dll

Crée une session cliente sécurisée pour les opérations de gestion des droits.

Surcharges

Create(String, ContentUser)	Crée une session cliente sécurisée pour un utilisateur spécifié avec un manifeste de droits donné.
Create(String, AuthenticationType, UserActivationMode)	Crée une session cliente sécurisée en fonction des éléments suivants : manifeste des droits de l’application, AuthenticationType et UserActivationMode.

Exemples

L’exemple suivant montre comment utiliser cette méthode pour créer un environnement sécurisé.

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)

Crée une session cliente sécurisée pour un utilisateur spécifié avec un manifeste de droits donné.

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

Paramètres

applicationManifest

String

Manifeste des droits de l’application.

user

ContentUser

Utilisateur ou groupe d’utilisateurs auquel accorder l’accès au contenu géré par des droits.

Retours

SecureEnvironment

Session cliente sécurisée pour l’activation, la liaison de licence et d’autres opérations de gestion des droits.

Exemples

L’exemple suivant montre comment utiliser cette méthode pour créer un environnement sécurisé.

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

Remarques

Cette Create méthode est destinée à être utilisée avec les utilisateurs qui sont déjà activés, tels que fournis dans la liste retournée par GetActivatedUsers. Utilisez la méthode alternative Create pour les utilisateurs qui ne sont pas encore activés.

Voir aussi

• UserActivationMode

Create(String, AuthenticationType, UserActivationMode)

Crée une session cliente sécurisée en fonction des éléments suivants : manifeste des droits de l’application, AuthenticationType et 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

Paramètres

applicationManifest

String

Manifeste des droits de l’application.

authentication

AuthenticationType

Méthode d’authentification.

userActivationMode

UserActivationMode

Type du certificat de compte de droits de l’utilisateur.

Retours

SecureEnvironment

Session cliente sécurisée pour l’activation, la liaison de licence et d’autres opérations de gestion des droits.

Exemples

L’exemple suivant montre comment utiliser cette méthode pour créer un environnement sécurisé.

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

Remarques

Cette Create méthode est destinée aux nouveaux utilisateurs qui ne sont pas encore activés.

L’activation d’un nouvel utilisateur inclut une transaction de serveur aller-retour pour obtenir le certificat utilisateur et le certificat de licence client.

La méthode alternative Create peut être utilisée si un utilisateur est déjà activé, tel que fourni dans la liste retournée par GetActivatedUsers.