SSLRequireSecureChannel Property of the IFPCWebPublishingProperties Interface

Article
08/13/2010

The SSLRequireSecureChannel property gets or sets a value from the FpcSSLRequireSecureChannelMode enumerated type that indicates whether a secure channel is required and whether 128-bit encryption is required.

C++

HRESULT put_SSLRequireSecureChannel(
    FpcSSLRequireSecureChannelMode FpcSSLRequireSecureChannelMode
);
HRESULT get_SSLRequireSecureChannel(
    FpcSSLRequireSecureChannelMode* pFpcSSLRequireSecureChannelMode
);

Parameters

FpcSSLRequireSecureChannelMode
Value from the FpcSSLRequireSecureChannelMode enumerated type that indicates whether a secure channel is required and whether 128-bit encryption is required.
pFpcSSLRequireSecureChannelMode
Pointer to a value from the FpcSSLRequireSecureChannelMode enumerated type that is set on return to:
- fpcSSLDontRequireSecureChannel, which indicates that a secure channel is not required.
- fpcSSLRequireSecureChannel, which indicates that a secure channel is required.
- fpcSSLRequire128BitSecureChannel, which indicates that a secure channel using 128-bit encryption is required.
- fpcSSLRequireBoth, which indicates that a secure channel and 128-bit encryption are required.

Return Value

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

Visual Basic

Property SSLRequireSecureChannel As FpcSSLRequireSecureChannelMode

Property Value

Value from the FpcSSLRequireSecureChannelMode enumerated type. The possible values are:

fpcSSLDontRequireSecureChannel, which indicates that a secure channel is not required.
fpcSSLRequireSecureChannel, which indicates that a secure channel is required.
fpcSSLRequire128BitSecureChannel, which indicates that a secure channel using 128-bit encryption is required.
fpcSSLRequireBoth, which indicates that a secure channel and 128-bit encryption are required.

Remarks

This property is read/write. The default value is fpcSSLDontRequireSecureChannel, which indicates that a secure channel is not required.

If the Web listener referenced in the WebListenerUsed property is configured to listen for both HTTP and HTTPS requests and this property requires an SSL channel, users attempting to connect to the Web site using HTTP will be notified that they must use HTTPS instead.

Requirements

Client	Requires Windows 7 or Windows Vista.
Server	Requires Windows Server 2008 R2 or Windows Server 2008 x64 Edition with SP2.
Version	Requires Forefront Threat Management Gateway (TMG) 2010.
IDL	Declared in Msfpccom.idl.
DLL	Requires Msfpccom.dll.