Share via


IPassportManager3 Interface

IPassportManager3 Interface

The IPassportManager3 interface is another secondary interface for the Passport Manager object. The Passport Manager object is a server-side object for the Microsoft® .NET Passport single sign-in (SSI) service, which uses cookies and query string data as intermediaries for querying a central user store.

Accessing IPassportManager3 Methods from C++ Code

Header Files

The Passport header file, passport.h, can be found in the \include subdirectory. The Passport library file, passport.lib, can be found in the \lib\x86 subdirectory.

QueryInterface on Passport Manager Object

To access the IPassportManager3 interface, query for it in an already existing Passport Manager object. For information about object instantiation, see Passport Manager Object.

After the object is available, and IPassportManager3 is available from headers, call:

IUnknown* pII_IPassportManager3;
oPassportManager->QueryInterface(IID_IPassportManager3, &pII_IPassportManager3);
//free reference when done;

IPassportManager3 Interface Methods

IPassportManager3::GetCurrentConfig

Returns the contents of a registry key under the registry hive HKLM\SW\Microsoft\Passport. The first parameter specifies the name of the key as seen in the registry.

IPassportManager3::GetLoginChallenge

Returns URL and header information to facilitate a .NET Passport sign-in, but does not automatically redirect to the URL. This method supports .NET Passport-aware client applications and the Credentials Manager used in the Microsoft® Windows® XP operating system.

IPassportManager3::HexPUID

A utility function that returns the .NET Passport Unique ID (PUID) of the currently connected .NET Passport user as a hexadecimal string.

IPassportManager3::LogoutURL

Returns the URL of the appropriate network sign-out page for the currently connected .NET Passport user, including any necessary query string parameters.

IPassportManager3::OnStartPageHTTPRaw

Initializes the Passport Manager object using the supplied input variables instead of handling query strings and cookies through the built-in OnStartPage method. OnStartPageHTTPRaw replaces OnStartPageManual. This method can be used to debug Microsoft® Internet Information Services (IIS)-related instantiation problems.

IPassportManager3::Ticket

Provides a way for participating sites to query a Ticket for specific properties.

Information

Implementation Passport Manager object
Inherits from IPassportManager2 Interface
Header and IDL files passport.h, passport.idl
Minimum operating systems Windows NT4 SP4 Server, Windows 2000 Server

See Also

IPassportManager2 Interface