Optional
aInstancePtr: objectA run time mechanism for interface discovery.
NS_OK if the interface is supported by the associated instance, NS_NOINTERFACE if it is not.
aInstancePtr must not be null.
[in] A requested interface IID
[out] A pointer to an interface pointer to receive the result.
Called to get the next token in a sequence of authentication steps.
A buffer containing the input token (e.g., a challenge from a server). This may be null.
The length of the input token.
If getNextToken succeeds, then aOutToken will point to a buffer to be sent in response to the server challenge. The length of this buffer is given by aOutTokenLength. The buffer at aOutToken must be recycled with a call to free.
If getNextToken succeeds, then aOutTokenLength contains the length of the buffer (number of bytes) pointed to by aOutToken.
Other flags may be defined in the future
Called to initialize an auth module. The other methods cannot be called unless this method succeeds.
the service name, which may be null if not applicable (e.g., for NTLM, this parameter should be null).
a bitwise-or of the REQ_ flags defined above (pass REQ_DEFAULT for default behavior).
the authentication domain, which may be null if not applicable.
the user's login name
the user's password
Unwrap() is used to unpack, decrypt, and verify the checksums on data returned by a server when security layers are in use.
A buffer containing the data received from the server
The length of the input token
A buffer containing the plaintext data from the server
The length of the output token buffer
Unwrap() may return NS_ERROR_NOT_IMPLEMENTED, if the underlying authentication mechanism does not support security layers.
Once a security context has been established through calls to GetNextToken() it may be used to protect data exchanged between client and server. Calls to Wrap() are used to protect items of data to be sent to the server.
A buffer containing the data to be sent to the server
The length of the input token
If set to true, Wrap() will encrypt the data, otherwise data will just be integrity protected (checksummed)
A buffer containing the resulting data to be sent to the server
The length of the output token buffer
Wrap() may return NS_ERROR_NOT_IMPLEMENTED, if the underlying authentication mechanism does not support security layers.
Generated using TypeDoc
Increases the reference count for this interface. The associated instance will not be deleted unless the reference count is returned to zero.
Returns
The resulting reference count.