Server Object

The Server object represents the ILS server with which the application interacts.

IIlsServer Interface

Back to ILS Reference

IIlsServer Interface

The IIlsServer interface is obtained from the IIlsMain::CreateServer method. The interface provides the methods described in this section.

SetAuthenticationMethod

SetBaseDN

SetCredential

SetDomain

SetLogonName

SetLogonPassword

SetTimeout

Back to Server Object

IIlsServer::SetAuthenticationMethod

HRESULT IIlsServer::SetAuthenticationMethod(
    ILS_ENUM_AUTH_METHOD  enumAuthMethod);

Sets the server authentication method to use when accessing this ILS server.

• Returns S_OK if successful, or ILS_E_PARAMETER if enumAuthMethod is incorrect.

enumAuthMethod

Authentication method to use when accessing this server.

Back to IIlsServer Interface

Back to Server Object

Back to ILS Object Listing

IIlsServer::SetBaseDN

HRESULT SetBaseDN(
    [in]  BSTR bstrBaseDN );

Sets the LDAP distinguished name base the user is to register under. If this method is not called, the ILS 1.0 default is used.

• Returns one of the following values:

  S_OK	Success.
  ILS_E_POINTER	bstrBaseDN is NULL.
  ILS_E_MEMORY	Unable to allocate enough memory for this request.

bstrBaseDN

LDAP distinguished name string, containing the organization and organizational unit specification. For example: "o=company, ou=division, ou=department".

The User object is registered according to the following rules:

• Country—The country attribute of the User object will be used for the LDAP "c=" specification.
• Common Name—The common name is the UserID field from the User object, thus "cn=userid".
• BaseDN—The base DN is the organization and organizational unit specification.

Back to IIlsServer Interface

Back to Server Object

Back to ILS Object Listing

IIlsServer::SetCredential

HRESULT IIlsServer::SetCredential(
    BSTR  bstrCredential);

Sets the server access credential when accessing this ILS server.

• Returns one of the following values:

  S_OK	Success.
  ILS_E_POINTER	bstrCredential is NULL.
  ILS_E_MEMORY	Unable to allocate enough memory for this request.

bstrCredential

Null-terminated string for the credential.

Back to IIlsServer Interface

Back to Server Object

Back to ILS Object Listing

IIlsServer::SetDomain

HRESULT IIlsServer::SetDomain(
    BSTR  bstrDomain);

Sets the Microsoft® Windows NT® domain when accessing this ILS server.

• Returns one of the following values:

  S_OK	Success.
  ILS_E_POINTER	bstrDomain is NULL.
  ILS_E_MEMORY	Unable to allocate enough memory for this request.

bstrDomain

Null-terminated string for the Windows NT domain name.

Back to IIlsServer Interface

Back to Server Object

Back to ILS Object Listing

IIlsServer::SetLogonName

HRESULT IIlsServer::SetLogonName(
    BSTR  bstrLogonName);

Sets the logon name to use when accessing this ILS server.

• Returns one of the following values:

  S_OK	Success.
  ILS_E_POINTER	bstrLogonName is NULL
  ILS_E_MEMORY	Unable to allocate enough memory for this request.

bstrLogonName

Null-terminated string for the logon name.

Back to IIlsServer Interface

Back to Server Object

Back to ILS Object Listing

IIlsServer::SetLogonPassword

HRESULT IIlsServer::SetLogonPassword(
    BSTR  bstrLogonPassword);

Sets the logon password to use when accessing this ILS server.

• Returns one of the following values:

  S_OK	Success.
  ILS_E_POINTER	bstrLogonPassword is NULL.
  ILS_E_MEMORY	Unable to allocate enough memory for this request.

bstrLogonPassword

Null-terminated string for the logon password.

Back to IIlsServer Interface

Back to Server Object

Back to ILS Object Listing

IIlsServer::SetTimeout

HRESULT IIlsServer::SetTimeout(
    ULONG  uTimeoutInSec);

Sets the initial time-out period when registering with this ILS server.

• Returns S_OK if successful.

uTimeoutInSec

Time-out period to use initially when accessing this ILS server.

Note that the time-out period is the initial amount suggested to the server; the ILS server can alter the time-out period unilaterally. The ILS client will honor any such changes and alter its time-out refresh frequency as necessary.

Back to IIlsServer Interface

Back to Server Object

Back to ILS Object Listing

Last Updated: November 1, 1997
© 1997 Microsoft Corporation. All rights reserved. Terms of Use.