BasicAuthentication Property of the IFPCWebListenerProperties Interface

The BasicAuthentication property gets or sets a Boolean value that indicates whether Basic authentication is used.


HRESULT put_BasicAuthentication(
    VARIANT_BOOL fBasicAuthentication
HRESULT get_BasicAuthentication(
    VARIANT_BOOL* pfBasicAuthentication


  • fBasicAuthentication
    Boolean value that indicates whether Basic authentication is used.

  • pfBasicAuthentication
    Pointer to a Boolean variable that is set on return to VARIANT_TRUE if Basic authentication is used, or to VARIANT_FALSE if Basic authentication is not used.

Return Value

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

Visual Basic

Property BasicAuthentication As Boolean

Property Value

Boolean value that indicates whether Basic authentication is used.


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

The standard Hypertext Transfer Protocol (HTTP) method of authentication is Basic authentication. Basic authentication sends and receives user information as text characters that can be easily read. Although passwords and user names are encoded, no encryption is used with Basic authentication. The following describes the authentication procedure for Basic authentication:

  1. The client prompts the user for credentials, which consist of a user name and password.
  2. The credentials are then encoded by the client and sent to the server.
  3. The user name is verified as being an account on the Forefront TMG computer or in a trusted domain of the Forefront TMG computer.

Basic authentication can be enabled for a Web listener together with Digest authentication, Integrated authentication, and SSL certificate authentication.


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.

Declared in Msfpccom.idl.


Requires Msfpccom.dll.

See Also


Send comments about this topic to Microsoft

Build date: 6/30/2010