IISDsCrMap::SetPwd

The SetPwd method sets a new value for the Windows password String in an existing certificate mapping. Four seek methods are available to search for the mapping: by certificate, by name, by Windows account, and by numeric String index.

HRESULT SetPwd(
  LONG  lMethod,
  VARIANT  vKey,
  BSTR  bstrPwd
);

Parameters

  • lMethod
    [in] Long integer containing the seek method to use for searching the mappings. Valid seek methods are 1, 2, 3, or 4. Seek method 1 specifies search by certificate, seek method 2 searches by name, method 3 searches by Windows account, and method 4 searches by a 1-based numeric string index (for example, "1," "2," and so on).

  • vKey
    [in] VARIANT containing the key to use in the search specified by lMethod. For seek method 1, vKey specifies a certificate. For seek method 2, vKey specifies a name. For seek method 3, vKey specifies a Windows account. For seek method 4, vKey specifies a numeric string index (for example, "1," "2," and so on).

  • bstrPwd
    [in] String containing a new value for the Windows password string.

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