Share via

3.2.4.2 NtFrsApi_Rpc_Get_DsPollingIntervalW (Opnum 5)

  • Article

The NtFrsApi_Rpc_Get_DsPollingIntervalW method MUST return the current Active Directory polling intervals.

Provides the current, long, and short polling intervals. All polling intervals are in minutes.

 unsigned long NtFrsApi_Rpc_Get_DsPollingIntervalW(
   [in] handle_t Handle,
   [out] unsigned long* Interval,
   [out] unsigned long* LongInterval,
   [out] unsigned long* ShortInterval
 );

Handle: Binding handle obtained when the partner authenticates with the file replication service.

Interval: Current interval in minutes, which MUST be the same value as either LongInterval or ShortInterval (see section 3.1.2).

LongInterval: Long interval in minutes.

ShortInterval: Short interval in minutes.

Return Values: The method MUST return 0 on success or a nonzero error code on failure. All nonzero values MUST be treated as equivalent failures unless otherwise specified.

Return value/code

Description

0x00000000

ERROR_SUCCESS

The method completed successfully.

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

Validating the _Rpc_Get_DsPollingIntervalW request: The server must validate the NtFrsApi_Rpc_Get_DsPollingIntervalW request by performing the following checks.

  • If IsGetDsPollingIntervalAccessCheckEnabled is set to "None", the server MUST fail the call with an implementation-specific value.

  • If IsGetDsPollingIntervalAccessCheckEnabled is set to "Disabled", the server MUST process the request without performing an access check.

  • If IsGetDsPollingIntervalAccessCheckEnabled is set to "Enabled", the server MUST check whether the calling client is authorized to perform that function. If the client is not authorized to perform that function, the server MUST return ERROR_NOT_AUTHENTICATED.

  • If GetDsPollingIntervalAccessRequired is set to "None", the server MUST fail the call with an implementation-specific value.

  • If GetDsPollingIntervalAccessRequired is set to "Read", the server MUST verify that the caller has read access. If the caller does not have read access, the server MUST return FRS_ERR_INSUFFICIENT_PRIV.

  • If GetDsPollingIntervalAccessRequired is set to "Write", the server MUST verify that the caller has write access. If the caller does not have write access, the server MUST return FRS_ERR_INSUFFICIENT_PRIV.