This documentation is archived and is not being maintained.

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

public interface IUccCredential : IUnknown
public interface IUccCredential extends IUnknown
public interface IUccCredential extends IUnknown

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

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(
   else if (pServer.Server.TransportMode == UCC_TRANSPORT_MODE.UCCTM_TLS)
      returnValue = credentialCache.DefaultCredential;
   return returnValue;

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