Microsoft Internet Security and Acceleration Server 2000

IFWXFirewall::GetNATSession Method

Gets, or if necessary, creates a SecureNAT session object for a given client.

HRESULT GetNATSession(
  LPSOCKADDR Address,
  DWORD AddressLength,
  IFWXSession **ppiPNATSession
);

Address: [in] Pointer to a sockaddr structure that contains the address of the SecureNAT client for which the session object is needed. The port is ignored.
AddressLength: [in] Length, in bytes, of the structure pointed to by the Address parameter.
ppiPNATSession: [out] Address of a variable that receives a pointer to the IFWXSession interface on the SecureNAT session object for the given address.

Inbound primary connections can be directed to a SecureNAT client by using the IFWXFirewall::CreatePrivateSession or IFWXFirewall::GetNATSession method. Use IFWXFirewall::CreatePrivateSession when the inbound connection has been requested by an application, the SecureNAT client is not known by the Firewall service, and no session object has been created. Use IFWXFirewall::GetNATSession only if the filter can assert that the client is configured to be a SecureNAT client of that server.