IOmNavigator

IOmNavigator


This interface provides access to an object that contains information about the browser.

IOmNavigator Methods
get_appCodeName   get_appName   get_appVersion  
get_userAgent   javaEnabled   taintEnabled  
get_mimeTypes   get_plugins   get_cookieEnabled  
get_opsProfile   toString   get_cpuClass  
get_systemLanguage   get_browserLanguage   get_userLanguage  
get_platform   get_appMinorVersion   get_connectionSpeed  
get_onLine   get_userProfile  

IOmNavigator::get_appCodeName

HRESULT get_appCodeName( 
    BSTR *p 
);

Retrieves the code name of the browser.

p
Address of a string variable that receives the code name.

IOmNavigator::get_appMinorVersion

HRESULT get_appMinorVersion(
    BSTR *p 
);

Returns a string of the minor version number of the browser.

p
Address of a string variable that receives the minor version number.

IOmNavigator::get_appName

HRESULT get_appName(
    BSTR *p 
);

Retrieves the application name of the browser.

p
Address of a string variable that receives the application name.

IOmNavigator::get_appVersion

HRESULT get_appVersion( 
    BSTR *p 
);

Retrieves the version of the browser.

p
Address of a string variable that receives the version information.

IOmNavigator::get_browserLanguage

HRESULT get_browserLanguage( 
    BSTR *p 
);

Currently not implemented.

IOmNavigator::get_connectionSpeed

HRESULT get_connectionSpeed(
    long *p 
);

Currently not implemented.

IOmNavigator::get_cookieEnabled

HRESULT get_cookieEnabled(
    VARIANT_BOOL *p 
);

Determines whether client-side cookies are enabled in the browser.

p
Address of a variable that receives TRUE if client-side cookies are enabled, or FALSE otherwise.

IOmNavigator::get_cpuClass

HRESULT get_cpuClass( 
    BSTR *p 
);

Returns a string of the CPU class (for example, "x86", "Alpha", "Other").

p
Address of a string variable that receives the cpuClass value.

IOmNavigator::get_mimeTypes

HRESULT get_mimeTypes(
    IHTMLMimeTypesCollection **p 
);

Retrieves an empty collection for Internet Explorer 4.0. This property exists for compatibility with other browsers.

enabled
Address of a variable that receives an interface pointer for the collection.

See also IHTMLMimeTypesCollection

IOmNavigator::get_onLine

HRESULT get_onLine(
    VARIANT_BOOL *p 
);

Returns a Boolean indicating whether the browser is running online or offline.

p
Address of a variable that receives TRUE if the browser is running online, or FALSE otherwise.

IOmNavigator::get_platform

HRESULT get_platform(
    BSTR *p 
);

Returns a string indicating which platform the browser is currently running on (for example, "Win32", "Win16", "WinCE", and so on).

p
Address of a string variable that receives the operating platform type.

IOmNavigator::get_opsProfile

HRESULT get_opsProfile( 
    IHTMLOpsProfile **p 
);

Returns an IHTMLOpsProfile interface pointer.

p
Address of a variable that receives an interface pointer to the IHTMLOpsProfile object.

The IHTMLOpsProfile element is a profile object that stores various types of information about the user. This information is taken from the Address Book.

IOmNavigator::get_plugins

HRESULT get_plugins( 
    IHTMLPluginsCollection **p 
);

Retrieves an interface pointer to a zero-based collection of all the EMBED elements in an HTML document. The elements are in the same order as they appear in the document.

p
Address of a variable that receives the interface pointer.

The collection is indexed first by name, then by ID. If duplicate names are found, a collection of those named items is returned. The resulting collection can be referenced only by ordinal position.

See also IHTMLPluginsCollection

IOmNavigator::get_systemLanguage

HRESULT get_systemLanguage( 
    BSTR *p 
);

Returns a string of the default language the system is running with.

p
Address of a string variable that receives the system language information.

IOmNavigator::get_userAgent

HRESULT get_userAgent(
    BSTR *p 
);

Retrieves a string that represents the user-agent header sent in the HTTP protocol from the client to the server.

p
Address of a string variable that receives the user-agent header.

IOmNavigator::get_userLanguage

HRESULT get_userLanguage(
    BSTR *p 
);

Returns a string indicating the language that the user is running by default.

p
Address of a string variable that receives the user language.

IOmNavigator::get_userProfile

HRESULT get_userProfile(
    IHTMLOpsProfile **p 
);

Alias for the IHTMLOpsProfile interface.

p
Address of a pointer to the IHTMLOpsProfile interface element.

The IHTMLOpsProfile element is a profile object that stores various types of information about the user. This information is taken from the Address Book.

IOmNavigator::javaEnabled

HRESULT javaEnabled(
    VARIANT_BOOL *enabled 
);

Returns whether Java is enabled.

enabled
Address of a variable that receives TRUE if Java is enabled, or FALSE otherwise.

IOmNavigator::taintEnabled

HRESULT taintEnabled( 
    VARIANT_BOOL *enabled 
);

Determines whether data tainting is enabled.

enabled
Address of a variable that receives TRUE if data tainting is enabled, or FALSE otherwise.

This method always returns FALSE for Internet Explorer 4.0. Data tainting is not supported.

IOmNavigator::toString

HRESULT toString(
    BSTR *string 
);

Returns a string representation of the navigation object.

string
Address of a string variable that represents the navigation object.

© 1997 Microsoft Corporation. All rights reserved. Terms of Use.