BlockInvalidUtf8Urls Property of IFPCWebProxy2[C++] | FPCWebProxy.BlockInvalidUtf8Urls [Visual Basic]

Internet Security and Acceleration Server 2004/2006 SDK

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 introduced in ISA Server 2006.)


HRESULT get_BlockInvalidUtf8Urls(
  VARIANT_BOOL* pfBlock );

HRESULT put_BlockInvalidUtf8Urls(
  VARIANT_BOOL fBlock );

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 Values

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 VARIANT_FALSE.

When this property is set to VARIANT_TRUE, ISA Server 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 VARIANT_TRUE.

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.

This property is not available in ISA Server 2004.

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 introduced in ISA Server 2006.)


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.

When this property is set to True, ISA Server 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.

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.

This property is not available in ISA Server 2004.

Requirements

Client Requires Windows XP.
Server Requires Windows Server 2003.
Version Requires Internet Security and Acceleration Server 2006.
IDL

Declared in Msfpccom.idl.

DLL Requires Msfpccom.dll.

See Also

FPCWebProxy

Show: