IUccCredential Interface

This content is no longer actively maintained. It is provided as is, for anyone who may still be using these technologies, with no warranties or claims of accuracy with regard to the most recent product version or service release.

Defines the interface used to represent a user credential.

Namespace: Microsoft.Office.Interop.UccApi
Assembly: Microsoft.Office.Interop.UccApi (in microsoft.office.interop.uccapi.dll)

Syntax

'Declaration
Public Interface IUccCredential
    Inherits IUnknown

public interface IUccCredential : IUnknown

public interface class IUccCredential : IUnknown

public interface IUccCredential extends IUnknown

public interface IUccCredential extends IUnknown

Remarks

The credential is encrypted and stored securely. A single credential can be added to a cache for a given security realm. The same credential can be added to the cache again when it is set for a different security realm.

A new instance of the IUccCredential interface is obtained from a credential cache by calling into either CreateCredential or DefaultCredential. These two methods are exposed by the IUccCredentialCache interface.

Win32 COM/C++ Syntax

interface IUccCredential : IUnknown

Example

The following example returns an instance of the UccCredential class. If the client is using the UCC_TRANSPORT_MODE.UCCTM_TCP transport mode, the new credential must have the user name, password, and domain. In other cases, the default credential supplied by the credential cache is sufficient.

private UccCredential NewCredential(
   IUccServerSignalingSettings pServer, 
   string pUserName, 
   string pPassword, 
   string pDomain)
{
   UccCredential returnValue = null;
   UccCredentialCache credentialCache = pServer.CredentialCache;
   if (pServer.Server.TransportMode == UCC_TRANSPORT_MODE.UCCTM_TCP)
   {
      returnValue = credentialCache.CreateCredential(
         pUserName, 
         pPassword, 
         pDomain);
   }
   else if (pServer.Server.TransportMode == UCC_TRANSPORT_MODE.UCCTM_TLS)
   {
      returnValue = credentialCache.DefaultCredential;
   }
   return returnValue;
}

Platforms

Development Platforms

Windows XP Professional with Service Pack 2 (SP2), Windows Server 2000 with Service Pack 4, Windows Server 2003, Windows Vista Ultimate Edition, Windows Vista Business Edition, Windows Vista Enterprise Edition

Target Platforms

See Also

Reference

IUccCredential Members
Microsoft.Office.Interop.UccApi Namespace