Share via

3.1.2.5.1.2 IObjectExporter::SimplePing (Opnum 1)

  • Article

The SimplePing method performs a ping of a previously allocated ping set to maintain the reference counts on the objects referred to by the set.

 [idempotent] error_status_t SimplePing(
   [in] handle_t hRpc,
   [in] SETID* pSetId
 );

hRpc: This MUST specify an RPC binding handle as specified in [MS-RPCE] section 3.2.2.3.1.

pSetId: MUST specify a SETID of the ping set to ping. This parameter MUST specify a SETID previously returned from a call to IObjectExporter::ComplexPing.

When processing this call:

  • The object resolver MAY compare the client's credentials against a set of implementation-specific permissions.<54> If the permissions do not allow access to the client credentials, the object resolver MUST return ERROR_ACCESS_DENIED (as specified in [MS-ERREF] section 2.2).

  • The object resolver MUST look up the SETID entry of the SETID designated by the client. If the entry is not found, it returns OR_INVALID_SET (as specified in [MS-ERREF] section 2.2).

  • If the entry is found, the object resolver MUST reset the ping set timer for the SETID entry.