NPN_GetAuthenticationInfo

« Gecko Plugin API Reference « Browser Side Plug-in API

Summary

The function is called by plugins to get HTTP authentication information from the browser.

Syntax

#include <npapi.h>

NPError NPN_GetAuthenticationInfo(NPP instance,
                                  const char *protocol,
                                  const char *host,
                                  int32_t port,
                                  const char *scheme,
                                  const char *realm,
                                  char **username,
                                  uint32_t *ulen,
                                  char **password,
                                  uint32_t *plen);

Parameters

This function has the following parameters:

instance: Pointer to the current plug-in instance

protocol: Protocol name (URI scheme)

host: Host name

port: Port number

scheme: HTTP authentication scheme name

realm: HTTP authentication realm

username: Out parameter. The browser passes back the HTTP username. If the function succeeds, the result buffer will be allocated with NPN_MemAlloc; the plugin is responsible for freeing the buffer. Note: the username may have internal NULL bytes and may not be NULL-terminated.

ulen: Out parameter. The length of the returned username buffer.

password: Out parameter. The browser passes back the HTTP password. If the function succeed, the result buffer will be allocated with NPN_MemAlloc; the plugin is responsible for freeing the buffer. Note: the password may have internal NULL bytes and may not be NULL-terminated.

plen: Out parameter. The length of the returned password buffer.

Returns

If successful, the function returns NPERR_NO_ERROR.
If unsuccessful, the function returns an error code. For possible values, see Error Codes.

Description

Plugin which implement their own HTTP networking stack (such as the Java plugin) may want to use the standard HTTP auth prompts and password managed of the browser. This function allows the plugin to ask the browser for HTTP authentication information for a domain.

Unless the plugin has special networking needs, it is recommended to use the standard network APIs, such as NPN_GetURLNotify/NPN_PostURLNotify.