Microsoft Internet Security and Acceleration Server 2004 SDK

IFWXNetConfigDetector::Register

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

HRESULT Register(
  IFWXNetConfigDetectionNotification* ipNcdNotification,
  BOOL fIssueAllNotifications,
  unsigned int* puiNcdRegistrationHandle
);

Parameters

ipNcdNotification
[in] A 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 Values

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

Requirements

Server: Requires Windows Server 2003 or Windows 2000.
Version: Requires Internet Security and Acceleration Server 2004.
Header: Declared in Wspfwext.idl.

See Also

IFWXNetConfigDetector, IFWXNetConfigDetectionNotification