PFAXACCESSCHECK callback function (winfax.h)
A fax client application calls the FaxAccessCheck function to query the fax access privileges of a user.
Syntax
PFAXACCESSCHECK Pfaxaccesscheck;
BOOL Pfaxaccesscheck(
[in] HANDLE FaxHandle,
[in] DWORD AccessMask
)
{...}
Parameters
[in] FaxHandle
Type: HANDLE
Specifies a fax server handle returned by a call to the FaxConnectFaxServer function.
[in] AccessMask
Type: DWORD
Specifies a DWORD variable that contains a set of bit flags defining a user's fax access permissions. This parameter can be one or more of the following generic access permissions: FAX_READ, FAX_WRITE, and FAX_ALL_ACCESS. It can also be one or more of the following specific access permissions:
- FAX_JOB_SUBMIT
- FAX_JOB_QUERY
- FAX_CONFIG_QUERY
- FAX_CONFIG_SET
- FAX_PORT_QUERY
- FAX_PORT_SET
- FAX_JOB_MANAGE
For a detailed description of these values, see Generic Fax Access Rights and Specific Fax Access Rights.
Return value
Type: BOOL
If the user has the required permission, the return value is nonzero.
If the user does not have the required permission, the return value is zero, and GetLastError returns ERROR_SUCCESS.
If the function fails, the return value is also zero, but GetLastError returns an error code other than ERROR_SUCCESS.
Remarks
The fax service is a secure service. Users must have certain access privileges to successfully call fax service functions. Call the FaxAccessCheck function to programmatically check a user's fax access permissions. For more information, see Checking the Access Rights of Users and Fax Client User Access Rights.
The fax service administration application, a Microsoft Management Console (MMC) snap-in component, is also available for users to query and modify job access, port access, and global configuration data access privileges.
Requirements
| Requirement | Value |
|---|---|
| Minimum supported client | Windows 2000 Professional [desktop apps only] |
| Minimum supported server | Windows 2000 Server [desktop apps only] |
| Target Platform | Windows |
| Header | winfax.h |
See also
Fax Service Client API Functions