IFaxSecurity2

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

このインターフェイスは Windows Vista 以降でのみサポートされます。それ以前のバージョンの Windows では IFaxSecurity を使用してください。

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

既定の実装は FaxSecurity2 として提供されます。

IFaxServer2 オブジェクトのセキュリティ記述子を表します。(Get)

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

このプロパティの読み取りと書き込みを行うには、ユーザーが far2MANAGE_CONFIG アクセス権を持っている必要があります。far2QUERY_CONFIG アクセス権を持つユーザーは、このプロパティを読み取ることができます。

IFaxServer2 オブジェクトのセキュリティ記述子を表します。(Put)

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

このプロパティの読み取りと書き込みを行うには、ユーザーが far2MANAGE_CONFIG アクセス権を持っている必要があります。far2QUERY_CONFIG アクセス権を持つユーザーは、このプロパティを読み取ることができます。

このプロパティを参照しているユーザーに付与されている FAX サーバーのアクセス権の組み合わせを取得します。

IFaxSecurity2::GrantedRights プロパティは FAX サーバーが付与する権限を反映します。これに対して Descriptor プロパティはセキュリティ記述子を表し、そこには FAX 管理者がユーザーに明示的に付与した権限が含まれます。

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

FAX サーバーから FaxSecurity2 オブジェクトの情報を再取得します。

型: HRESULT

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

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

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

FaxSecurity オブジェクトのデータを保存します。

型: HRESULT

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

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

セキュリティ情報の種類を取得します。(Get)

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

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

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

セキュリティ情報の種類を取得します。(Put)

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

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

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