IFWXNetConfigDetector::Register method

  • Article

Applies to: desktop apps only

The Register method registers an application filter to receive network configuration detection (NCD) events.

Syntax

HRESULT Register(
  [in]   IFWXNetConfigDetectionNotification *ipNcdNotification,
  [in]   BOOL fIssueAllNotifications,
  [out]  unsigned int *puiNcdRegistrationHandle
);

Parameters

  • ipNcdNotification [in]
    Pointer to an IFWXNetConfigDetectionNotification interface, which the application filter must implement.

  • fIssueAllNotifications [in]
    Boolean value that specifies whether the IFWXNetConfigDetector::Register method will return synchronously (after all notifications are issued) or asynchronously (before any notification is issued). When an application filter registers as an NCD client, as part of the registration process it will receive all the incremental notifications required to compose the current network configuration snapshot. This flag indicates whether the client receives all of these initial notifications synchronously (before its call to the IFWXNetConfigDetector::Register method returns) or asynchronously (after its call to the IFWXNetConfigDetector::Register method returns).

  • puiNcdRegistrationHandle [out]
    Unsigned integer value that specifies a registration handle created during the registration process.

Return value

This method returns S_OK if the call is successful; otherwise, it returns an error code.

Requirements

Minimum supported client

 None supported

Minimum supported server

 Windows Server 2008 R2, Windows Server 2008 with SP2 (64-bit only)

Version

 Forefront Threat Management Gateway (TMG) 2010

Header

 Wspfwext.idl

DLL

 Wspsrv.exe

See also

IFWXNetConfigDetector

IFWXNetConfigDetectionNotification

 

 

Build date: 7/12/2010