3.1.4.65 RRPC_FWEnumAuthenticationSets2_20 (Opnum 64)

  • Article

The RRPC_FWEnumAuthenticationSets2_20 method requests the server to return all the authentication sets of the specified IPsec phase contained in the store referenced in the hPolicy handle. The method returns a linked list of these objects. The method is only supported for binary version 0x0214.

 unsigned long RRPC_FWEnumAuthenticationSets2_20(
   [in] FW_CONN_HANDLE rpcConnHandle,
   [in] FW_POLICY_STORE_HANDLE hPolicy,
   [in, range(FW_IPSEC_PHASE_INVALID+1, FW_IPSEC_PHASE_MAX-1)] 
     FW_IPSEC_PHASE IpSecPhase,
   [in] DWORD dwFilteredByStatus,
   [in] WORD wFlags,
   [out] DWORD* pdwNumAuthSets,
   [out] PFW_AUTH_SET* ppAuth
 );

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

hPolicy: This input parameter is 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. The handle MUST have read/write access rights.

IpSecPhase: This parameter specifies the specific IPsec negotiation phase to which this set applies.

dwFilteredByStatus: This parameter is a combination of flags from the FW_RULE_STATUS_CLASS enumeration. This method uses this bitmask to determine which rules will be returned. Rules that contain a status code of the specified class that match this parameter will be returned in the linked list.

wFlags: This parameter is a combination of flags from the FW_ENUM_RULES_FLAGS enumeration, which modifies the behavior of the method and performs operations on the rules before returning them in the linked list.

pdwNumAuthSets: This is an output parameter that, on success, MUST be equal to the number of sets returned.

ppAuth: This parameter represents the authentication set the client has added to the store. The set MUST be valid, as specified in the definition of the FW_AUTH_SET data type.

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

Return value/code

Description

0x00000005

ERROR_ACCESS_DENIED

The hPolicy handle was not opened with read/write access rights. The error is also returned if the client does not have the required credentials to call the method.

0x00000057

ERROR_INVALID_PARAMETER

The dwProfileFilter parameter contains invalid profiles.

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