### GetMapping

The GetMapping method of the IIsCertMapper object retrieves a certificate and the mapping data from 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. The retrieved mapping is returned in parameter variables you provide.

###### Syntax

IIsCertMapper.GetMapping IMethod, vKey, vCert, NtAcct, NtPwd, strName, IEnabled

###### Parameters

IMethod
  Specifies 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
  Specifies the key to use in the search specified by IMethod. 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).
vCert
  Receives the returned certificate.
NtAcct
  Receives the returned Windows account.
NtPwd
  Receives the returned Windows account password.
strName
  Receives the returned Windows account friendly name.
IEnabled
  Receives the returned value TRUE for an enabled mapping, or FALSE for a disabled mapping.

###### Code Example

    <%
      Dim CertObj, vCert, NtAcct, NtPwd, strName, IEnabled
      Set CertObj = GetObject("IIS://..path../IIsCertMapper")
      'Search by Windows account.
      CertObj.GetMapping 3, "MYACCT", vCert, NtAcct, NtPwd, strName, IEnabled
    %>

###### See Also

CreateMapping, DeleteMapping, SetAcct, SetEnabled, SetName, SetPwd

© 1997-2001 Microsoft Corporation. All rights reserved.