Export (0) Print
Expand All

FwpmConnectionGetById0 function

The FwpmConnectionGetById0 function retrieves a connection object.

Syntax


DWORD WINAPI FwpmConnectionGetById0(
  _In_   HANDLE engineHandle,
  _In_   UINT64 id,
  _Out_  FWPM_CONNECTION0 **connection
);

Parameters

engineHandle [in]

Type: HANDLE

Handle for an open session to the filter engine. Call FwpmEngineOpen0 to open a session to the filter engine.

id [in]

Type: UINT64

The run-time identifier for the connection.

connection [out]

Type: FWPM_CONNECTION0**

The connection information.

Return value

Type: DWORD

Return code/valueDescription
ERROR_SUCCESS
0

The connection object was retrieved successfully.

FWP_E_* error code
0x80320001—0x80320039

A Windows Filtering Platform (WFP) specific error. See WFP Error Codes for details.

RPC_* error code
0x80010001—0x80010122

Failure to communicate with the remote or local firewall engine.

 

Remarks

The caller must free the returned object by a call to FwpmFreeMemory0.

The caller needs FWPM_ACTRL_READ access to the provider context. See Access Control for more information.

Requirements

Minimum supported client

Windows 8 [desktop apps only]

Minimum supported server

Windows Server 2012 [desktop apps only]

Header

Fwpmu.h

Library

Fwpuclnt.lib

DLL

Fwpuclnt.dll

See also

FWPM_CONNECTION0

 

 

Community Additions

ADD
Show:
© 2014 Microsoft