IFWXFilterAdmin::GetProtocol Method

Gets the FPCFilterProtocol interface, which provides access to a protocol previously installed by IFWXFilterAdmin::RegisterProtocolForFilter.

HRESULT GetProtocol(
  REFCLSID guidFilter,
  REFGUID guidProtocol,
  FwxScope Scope,
  IFPCFilterProtocol **ppProtocol
);

Parameters

guidFilter

[in] CLSID of an IFWXFilter object.

guidProtocol

[in] GUID that will be used for uniquely identifying the protocol.

Scope

[in] The scope of the filter object, either array or enterprise, as a value from the FwxScope enumerated type. The value fwx_DefaultScope can be used by get operations to retrieve the object scope that is appropriate for the current configuration. This parameter cannot be set to fwx_EnterpriseScope for a stand-alone server or for ISA Server Standard Edition.

ppProtocol

[out] Address of a variable that receives the interface pointer to the FPCFilterProtocol object.

Return Values

S_OK

Method succeeded.

E_OUTOFMEMORY

Insufficient memory or resources; method failed.

HRESULT_FROM_WIN32(ERROR_FILE_NOT_FOUND)

A filter with that GUID does not exist.

Remarks

Use this method to change the conifguration of a protocol.