GetProtocol Method of the IFWXFilterAdmin Interface

The GetProtocol method gets the FPCProtocolDefinition object, which provides access to protocols previously registered by the IFWXFilterAdmin::RegisterProtocol method.

Syntax

HRESULT GetProtocol(
  [in]   REFGUID guidProtocol,
  [out]  IFPCProtocolDefinition** ppProtocol
);

Parameters

guidProtocol

The protocol's GUID as specified by IFWXFilterAdmin::RegisterProtocol

ppProtocol

Address of a variable that receives the interface pointer to the FPCProtocolDefinition object.

Return Value

S_OK

The method succeeded.

E_OUTOFMEMORY

Not enough memory or resources could be allocated to complete the operation.

HRESULT_FROM_WIN32(ERROR_FILE_NOT_FOUND)

A filter with that GUID does not exist.

Remarks

Use this method to change the configuration of a protocol.

Requirements

Server	Requires Windows Server 2008.
Version	Requires Forefront Threat Management Gateway (TMG).
Header	Declared in Wspfwext.idl.
DLL	Requires Wspadmin.dll.

See Also

IFWXFilterAdmin

Send comments about this topic to Microsoft

Build date: 11/30/2009