Register Method of the IFWXNetConfigDetector Interface

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.
Version	Requires Forefront Threat Management Gateway (TMG).
Header	Declared in Wspfwext.idl.
DLL	Requires Wspsrv.exe.

See Also

IFWXNetConfigDetector
IFWXNetConfigDetectionNotification

Send comments about this topic to Microsoft

Build date: 11/30/2009