3.1.4.2.33 FaxObs_SetSecurityDescriptor (Opnum 32)

The client calls FaxObs_SetSecurityDescriptor (Opnum 32) method to set the fax security descriptor of the server. The client can retrieve the security descriptor of the server with the FaxObs_GetSecurityDescriptor (section 3.1.4.2.32) method.

On success, the server MUST apply the security descriptor described in the submitted FAX_SECURITY_DESCRIPTOR (section 2.2.90) structure.

 error_status_t FaxObs_SetSecurityDescriptor(
   [in] handle_t hBinding,
   [in, unique, size_is(BufferSize)] 
     const LPBYTE FaxSecurityDescriptor,
   [in] DWORD BufferSize
 );

hBinding: A handle that is provided by the client RPC layer when the RPC call is made.

FaxSecurityDescriptor: A pointer to a buffer containing a FAX_SECURITY_DESCRIPTOR to be set.

BufferSize: A DWORD ([MS-DTYP] section 2.2.9) containing the size, in bytes, of the data pointed at by the FaxSecurityDescriptor parameter.

Return Values: This method MUST return 0x00000000 (ERROR_SUCCESS) for success; otherwise, it MUST return one of the following error codes, one of the fax-specific errors that are defined in section 2.2.52, or one of the other standard errors defined in [MS-ERREF] section 2.2.

Return value/code	Description
ERROR_ACCESS_DENIED 0x00000005	Access is denied. The client's fax user account does not have the FAX_CONFIG_SET access rights.
ERROR_INVALID_DATA 0x0000000D	The security descriptor described by the FAX_SECURITY_DESCRIPTOR pointed at by the FaxSecurityDecriptor parameter is invalid.
ERROR_INVALID_PARAMETER 0x00000057	The parameter is incorrect. This error code is returned under any of the following conditions: § The value of the BufferSize parameter is less than the size of the Fixed_Portion block of the FAX_SECURITY_DESCRIPTOR. § An offset into the Fixed_Portion block of the FAX_SECURITY_DESCRIPTOR pointed at by the FaxSecurityDecriptor points to outside of the buffer.
ERROR_INVALID_CATEGORY 0x00000075	The fax server SHOULD return this error if the Id member of the FAX_SECURITY_DESCRIPTOR specified by the FaxSecurityDescriptor argument is set to a value greater than 0.<215>

Exceptions Thrown: No exceptions are thrown except those that are thrown by the underlying RPC protocol, [MS-RPCE].