SecureEnvironment.Create メソッド

リファレンス

定義

名前空間:: System.Security.RightsManagement

アセンブリ:: WindowsBase.dll

重要

一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。

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

オーバーロード

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 の方法を使用します。

こちらもご覧ください

UserActivationMode

適用対象

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

適用対象

SecureEnvironment.Create メソッド

定義

オーバーロード

例

Create(String, ContentUser)

パラメーター

戻り値

例

注釈

こちらもご覧ください

適用対象

Create(String, AuthenticationType, UserActivationMode)

パラメーター

戻り値

例

注釈

適用対象

その他のリソース