IFaxSecurity

IFaxSecurity 構成オブジェクトは、FAX クライアントアプリケーションが FAX サーバーのセキュリティを構成するために使用し、呼び出し元アプリケーションが FAX サーバーのセキュリティ記述子を設定および取得できるようにします。

FAX サーバーのセキュリティを構成できるのは、権限を持つ管理者のみです。詳細については、アクセス制御を参照してください。

IFaxSecurity の既定の実装は、FaxSecurity オブジェクトとして提供されます。

Descriptor プロパティは、IFaxServer オブジェクトのセキュリティ記述子を表します。(Get)

IFaxSecurity::Descriptor プロパティは、FAX 管理者によってユーザーに明示的に付与された権限を含むセキュリティ記述子を表します。IFaxSecurity::get_GrantedRights プロパティは、この記述子に基づいて FAX サーバーが付与するユーザー権限を反映します。具体的には、ユーザーがアクセス権 farSUBMIT_HIGH を持つ場合、そのユーザーは高優先度、通常優先度、および低優先度の FAX を送信できます。ユーザーがアクセス権 farSUBMIT_NORMAL を持つ場合、そのユーザーは通常優先度および低優先度の FAX を送信できます。

このプロパティを読み取るには、ユーザーが farQUERY_CONFIG アクセス権を持っている必要があります。

Descriptor プロパティは、IFaxServer オブジェクトのセキュリティ記述子を表します。(Put)

IFaxSecurity::Descriptor プロパティは、FAX 管理者によってユーザーに明示的に付与された権限を含むセキュリティ記述子を表します。IFaxSecurity::get_GrantedRights プロパティは、この記述子に基づいて FAX サーバーが付与するユーザー権限を反映します。具体的には、ユーザーがアクセス権 farSUBMIT_HIGH を持つ場合、そのユーザーは高優先度、通常優先度、および低優先度の FAX を送信できます。ユーザーがアクセス権 farSUBMIT_NORMAL を持つ場合、そのユーザーは通常優先度および低優先度の FAX を送信できます。

このプロパティを読み取るには、ユーザーが farQUERY_CONFIG アクセス権を持っている必要があります。

IFaxSecurity::get_GrantedRights プロパティは、このプロパティを参照するユーザーに付与された FAX サーバーのアクセス権の組み合わせです。

IFaxSecurity::get_GrantedRights プロパティは FAX サーバーによって付与された権限を反映するのに対し、IFaxSecurity::Descriptor プロパティは、FAX 管理者によってユーザーに明示的に付与された権限を含むセキュリティ記述子を表します。

このプロパティを読み取るには、ユーザーが farQUERY_CONFIG アクセス権を持っている必要があります。

IFaxSecurity::Refresh メソッドは、FaxSecurity オブジェクトの情報を FAX サーバーから更新します。

型: HRESULT

このメソッドが成功した場合は S_OK を返します。失敗した場合は HRESULT エラーコードを返します。

IFaxSecurity::Refresh メソッドを呼び出すと、最後に IFaxSecurity::Save メソッドを呼び出した後に行われた構成の変更はすべて失われます。

このプロパティを読み取るには、ユーザーが farQUERY_CONFIG アクセス権を持っている必要があります。

IFaxSecurity::Save メソッドは、FaxSecurity オブジェクトのデータを保存します。

型: HRESULT

このメソッドが成功した場合は S_OK を返します。失敗した場合は HRESULT エラーコードを返します。

このメソッドを使用するには、ユーザーが farMANAGE_CONFIG および farQUERY_CONFIG アクセス権を持っている必要があります。

IFaxSecurity::InformationType プロパティは、セキュリティ情報の種類を表します。(Get)

情報の種類はビット単位の組み合わせで、IFaxSecurity::Descriptor プロパティを使用してセキュリティ記述子を要求するとき、または IFaxSecurity::Refresh メソッドを使用して IFaxSecurity オブジェクトを更新するときに、サーバーからどのセキュリティ情報を取得するかを示します。また、情報の種類は、IFaxSecurity::Save メソッドを使用して IFaxSecurity オブジェクトへの変更を保存するときに、FAX サーバーへ送信される情報も決定します。

これらのビットは、Winnt.h で定義されている SECURITY_INFORMATION 構造体で指定されます。セキュリティ情報の各項目はビットフラグで指定されます。次の値は、FAX サービスに適用されるビットを示します。

IFaxSecurity::get_Descriptor メソッドを呼び出す前に IFaxSecurity::InformationType プロパティを設定して、必要な情報を確実に受け取れるようにし、かつ適切なアクセス権を持つ情報のみを要求するようにしてください。また、IFaxSecurity::InformationType プロパティは、IFaxSecurity::Save メソッドを呼び出したときに FAX サーバーへ送信される情報にも影響します。IFaxSecurity::InformationType プロパティを設定しない場合、既定では DACL_SECURITY_INFORMATION、GROUP_SECURITY_INFORMATION、および OWNER_SECURITY_INFORMATION の各フラグになります。

IFaxSecurity::InformationType プロパティは、セキュリティ情報の種類を表します。(Put)

情報の種類はビット単位の組み合わせで、IFaxSecurity::Descriptor プロパティを使用してセキュリティ記述子を要求するとき、または IFaxSecurity::Refresh メソッドを使用して IFaxSecurity オブジェクトを更新するときに、サーバーからどのセキュリティ情報を取得するかを示します。また、情報の種類は、IFaxSecurity::Save メソッドを使用して IFaxSecurity オブジェクトへの変更を保存するときに、FAX サーバーへ送信される情報も決定します。

これらのビットは、Winnt.h で定義されている SECURITY_INFORMATION 構造体で指定されます。セキュリティ情報の各項目はビットフラグで指定されます。次の値は、FAX サービスに適用されるビットを示します。

IFaxSecurity::get_Descriptor メソッドを呼び出す前に IFaxSecurity::InformationType プロパティを設定して、必要な情報を確実に受け取れるようにし、かつ適切なアクセス権を持つ情報のみを要求するようにしてください。また、IFaxSecurity::InformationType プロパティは、IFaxSecurity::Save メソッドを呼び出したときに FAX サーバーへ送信される情報にも影響します。IFaxSecurity::InformationType プロパティを設定しない場合、既定では DACL_SECURITY_INFORMATION、GROUP_SECURITY_INFORMATION、および OWNER_SECURITY_INFORMATION の各フラグになります。