IISDsCrMap::CreateMapping

The CreateMapping method maps an SSL certificate to a Windows account.

HRESULT CreateMapping(
  VARIANT  vCert,
  BSTR  bstrNtAcct,
  BSTR  bstrNtPwd,
  BSTR  bstrName,
  LONG  lEnabled
);

Parameters

  • vCert
    [in] VARIANT containing the certificate. The certificate is either a string or an array of bytes, usually obtained from the Request.ClientCertificate Collection collection of the built-in ASP Request Object.

  • bstrNtAcct
    [in] String containing the Windows NT account name.

  • bstrNtPwd
    [in] String containing the Windows NT password.

  • bstrName
    [in] String containing the friendly name for the account.

  • lEnabled
    [in] Long integer containing 1 to enable the mapping, 0 to disable the mapping

Return Value

The method returns an HRESULT. Possible values include, but are not limited to, S_OK, which indicates that the method succeeded.

Requirements

Client: Requires Windows XP Professional, Windows 2000 Professional, or Windows NT Workstation 4.0.

Server: Requires Windows Server 2003, Windows 2000 Server, or Windows NT Server 4.0.

Product: IIS

Header: Declared in iiisext.h; include iisext_i.c.

See Also

Concepts

IIS ADSI Provider Interfaces

Using ADSI to Configure IIS in a C++ Application

IIS Constants and Header Files