Win32 API 日本語リファレンス
ホーム › Devices.Fax › PFAXACCESSCHECK

PFAXACCESSCHECK

コールバック

シグネチャ

BOOL PFAXACCESSCHECK(
    HANDLE FaxHandle,
    DWORD AccessMask
);

パラメーター

フィールド型説明
FaxHandleHANDLEFaxConnectFaxServer 関数の呼び出しによって返されたファクスサーバーのハンドルを指定します。
AccessMaskDWORD

ユーザーのファクスアクセス許可を定義するビットフラグのセットを格納する DWORD 変数を指定します。このパラメーターには、次の汎用アクセス許可のうち 1 つ以上を指定できます: FAX_READ、FAX_WRITE、FAX_ALL_ACCESS。また、次の固有アクセス許可のうち 1 つ以上を指定することもできます。

これらの値の詳細については、Generic Fax Access Rights および Specific Fax Access Rights を参照してください。

公式ドキュメント

ファクスクライアントアプリケーションは、ユーザーのファクスアクセス権限を照会するために FaxAccessCheck 関数を呼び出します。

戻り値

Type: BOOL

ユーザーが必要な権限を持っている場合、戻り値は 0 以外の値です。

ユーザーが必要な権限を持っていない場合、戻り値は 0 になり、GetLastError は ERROR_SUCCESS を返します。

関数が失敗した場合も戻り値は 0 になりますが、GetLastError は ERROR_SUCCESS 以外のエラーコードを返します。

解説(Remarks)

ファクスサービスはセキュリティで保護されたサービスです。ファクスサービスの関数を正常に呼び出すには、ユーザーが特定のアクセス権限を持っている必要があります。ユーザーのファクスアクセス許可をプログラムから確認するには、FaxAccessCheck 関数を呼び出します。詳細については、Checking the Access Rights of Users および Fax Client User Access Rights を参照してください。

また、Microsoft 管理コンソール (MMC) のスナップインコンポーネントであるファクスサービス管理アプリケーションも用意されており、ユーザーはジョブアクセス、ポートアクセス、およびグローバル構成データへのアクセス権限を照会および変更できます。

出典・ライセンス: 上記「公式ドキュメント」の内容は Microsoft の Win32 API ドキュメント(MicrosoftDocs/sdk-api)を日本語に翻訳・改変したものです。© Microsoft Corporation. CC BY 4.0 で提供。
Microsoft 公式リファレンス: 英語 (en-us) · 日本語 (ja-jp) · 原文ソース (GitHub)