3.1.4.2 RRPC_FWClosePolicyStore (Opnum 1)

  • Article

The RRPC_FWClosePolicyStore method receives an opened store handle, closes it, and deallocates the corresponding PolicyStoreConnection object.

 unsigned long RRPC_FWClosePolicyStore(
   [in] FW_CONN_HANDLE rpcConnHandle,
   [in, out] PFW_POLICY_STORE_HANDLE phPolicyStore
 );

rpcConnHandle: This parameter is an RPC binding handle that connects to the RPC interface of the Firewall and Advanced Security Protocol.

phPolicyStore: This is an input and output parameter that provides a pointer to an FW_POLICY_STORE_HANDLE data type. The data type MUST contain an opened policy store handle, successfully opened with the RRPC_FWOpenPolicyStore (Opnum 0) method, which the client intends to stop using and close.

Return Values: The method returns 0 if successful; if failed, it returns a nonzero error code. The field can take any specific error code value, as specified in [MS-ERREF].

Exceptions Thrown: No exceptions are thrown beyond those thrown by the underlying RPC protocol, as specified in [MS-RPCE]. If any lower-layer errors are reported by RPC exception, this exception is converted to an error code and reported to higher-layer protocols via the return value.

The server MUST validate that the client is authorized to perform the requested operation (as defined in section 3.1.4) before executing this method.