IPassportManager3 Interface
.jpg)
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
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.
A utility function that returns the .NET Passport Unique ID (PUID) of the currently connected .NET Passport user as a hexadecimal string.
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.
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