SecureEnvironment.Create メソッド

  • リファレンス

定義

名前空間:
System.Security.RightsManagement
アセンブリ:
WindowsBase.dll

権限管理操作にとって安全なクライアント セッションを作成します。

オーバーロード

Create(String, ContentUser)

指定された権限マニフェストを使用して、指定されたユーザーのセキュリティで保護されたクライアント セッションを作成します。
Create(String, AuthenticationType, UserActivationMode)

アプリケーションの権利マニフェスト、AuthenticationType、および UserActivationMode が指定された、セキュリティで保護されたクライアント セッションを作成します。

例

次の例は、このメソッドを使用してセキュリティで保護された環境を作成する方法を示しています。

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)

指定された権限マニフェストを使用して、指定されたユーザーのセキュリティで保護されたクライアント セッションを作成します。

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

パラメーター

applicationManifest
String

アプリケーションの権限マニフェスト。

user
ContentUser

権限が管理されたコンテンツへのアクセス権を付与するユーザーまたはユーザー グループ。

戻り値

SecureEnvironment

アクティブ化、ライセンスのバインド、およびその他の権限管理操作のための、セキュリティで保護されたクライアント セッション。

例

次の例は、このメソッドを使用してセキュリティで保護された環境を作成する方法を示しています。

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 メソッドは、既にアクティブ化されているユーザー (例: から返されるリストで提供) GetActivatedUsersで使用することを目的としています。 アクティブ化されていないユーザーには、別 Create の方法を使用します。

こちらもご覧ください

適用対象

Create(String, AuthenticationType, UserActivationMode)

アプリケーションの権利マニフェスト、AuthenticationType、および 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

パラメーター

applicationManifest
String

アプリケーションの権限マニフェスト。

authentication
AuthenticationType

認証の方法。

userActivationMode
UserActivationMode

ユーザー権利のアカウント証明書の種類。

戻り値

SecureEnvironment

アクティブ化、ライセンスのバインド、およびその他の権限管理操作のための、セキュリティで保護されたクライアント セッション。

例

次の例は、このメソッドを使用してセキュリティで保護された環境を作成する方法を示しています。

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 メソッドは、まだアクティブ化されていない新しいユーザーを対象としています。

新しいユーザーのアクティブ化には、ユーザー証明書とクライアント ライセンス証明書を取得するためのラウンドトリップ サーバー トランザクションが含まれます。

別Createの方法は、ユーザーが既にアクティブ化されている場合に使用できます (例: から返されるリストで指定)。GetActivatedUsers

適用対象