Share via

Register Method of the IFWXNetConfigDetector Interface

  • Article

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
    Pointer to an IFWXNetConfigDetectionNotification interface, which the application filter must implement.

  • fIssueAllNotifications
    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
    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

Server Requires Windows Server 2008 R2 or Windows Server 2008 x64 Edition with SP2.
Version Requires Forefront Threat Management Gateway (TMG) 2010.
Header

Declared in Wspfwext.idl.
DLL

Requires Wspsrv.exe.

See Also

IFWXNetConfigDetector
IFWXNetConfigDetectionNotification

Send comments about this topic to Microsoft

Build date: 6/30/2010