IFPCWebProxy2::BlockInvalidUtf8Urls property

Article
08/27/2012

Applies to: desktop apps only

The BlockInvalidUtf8Urls property gets or sets a Boolean value that indicates whether requests with an invalid UTF8-encoded URL will be blocked.

This property is read/write.

Syntax

HRESULT put_BlockInvalidUtf8Urls(
  VARIANT_BOOL fBlock
);

HRESULT get_BlockInvalidUtf8Urls(
  VARIANT_BOOL *pfBlock
);

' Data type: Boolean

Property BlockInvalidUtf8Urls( _
  ByVal fBlock As VARIANT_BOOL, _
  ByVal pfBlock As VARIANT_BOOL _
) As Boolean

Property value

Boolean value that indicates whether requests with an invalid UTF8-encoded URL will be blocked.

Error codes

These property methods return S_OK if the call is successful; otherwise, they return an error code.

Remarks

This property is read/write. Its default value is False (VARIANT_FALSE in C++).

When this property is set to True (VARIANT_TRUE in C++), Forefront TMG verifies the validity of the URL in each request, assuming that the URL is encoded in UTF8 format, and blocks a request if the URL is found to be invalid. URLs that contain international characters and are not encoded in UTF8 format will be considered invalid. Nevertheless, as a best security practice, we recommend that you change the value of this property to True (VARIANT_TRUE in C++).

After the collection of references has been modified, the changes must be written to persistent storage by calling the Save method, and the Microsoft Firewall service must be restarted for the changes to take effect. For more information about restarting the Firewall service to apply changes, see Restarting Services after Configuration Changes.

Requirements

Minimum supported client	Windows Vista
Minimum supported server	Windows Server 2008 R2, Windows Server 2008 with SP2 (64-bit only)
Version	Forefront Threat Management Gateway (TMG) 2010
IDL	Msfpccom.idl
DLL	Msfpccom.dll