BlockInvalidUtf8Urls Property of the IFPCWebProxy2 Interface

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

[C++]
HRESULT put_BlockInvalidUtf8Urls(
	VARIANT_BOOL fBlock
);
HRESULT get_BlockInvalidUtf8Urls(
	VARIANT_BOOL* pfBlock
);

Parameters

pfBlock

Pointer to a Boolean variable that is set on return to VARIANT_TRUE if requests with an invalid UTF8-encoded URL will be blocked, or to VARIANT_FALSE if requests with an invalid UTF8-encoded URL will not be blocked.

fBlock

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

Return Value

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

[Visual Basic]
Property BlockInvalidUtf8Urls As Boolean

Property Value

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

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

Client Requires Windows Vista or Windows XP.
Server Requires Windows Server 2008.
Version Requires Forefront Threat Management Gateway (TMG).
IDL

Declared in Msfpccom.idl.

DLL

Requires Msfpccom.dll.

See Also

FPCWebProxy


Send comments about this topic to Microsoft

Build date: 11/30/2009

© 2008 Microsoft Corporation. All rights reserved.