3.1.4.2.34 FaxObs_GetSecurityDescriptorCount (Opnum 33)

The client calls the FaxObs_GetSecurityDescriptorCount (Opnum 33) method to retrieve the total number of fax security descriptors from the server.

On success, the server MUST return the total number of security descriptors. This number MUST be 1.

 error_status_t FaxObs_GetSecurityDescriptorCount(
   [in] handle_t hBinding,
   [out] LPDWORD Count
 );

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

Count: A pointer to a DWORD ([MS-DTYP] section 2.2.9) value containing on return the number of security descriptors. On a successful return, the server MUST set this parameter to a value of 1.

Return Values: This method MUST return 0x00000000 (ERROR_SUCCESS) for success; otherwise, it MUST return 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. There are no predefined error codes to be returned by this method.

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