zNewConnection

Creates a connection to NSS as the specified user.

Service:File System Services (64-Bit)
Version:OES 2 SP1

Syntax

#include <zPublics.h>

STATUS zNewConnection(
   Key_t            rootkey,
   const unicode_t  *fdn)

Parameters

rootkey

(IN) Specifies the authentication key that is obtained from zRootKey(). Once you complete with the key, release it by calling zClose. When the connection key is closed, the NSS resources and keys associated with that connection are released.

const unicode_t *fdn

(IN) Points to the fully distinguished name of the user to which you want to establish the connection.

Return Values

zOK

The operation completed successfully.

non-0

An error occurred (see Section 4.1, Return Values for a description).

Remarks

zNewConnection works only with zRootKey.

See Also

zClose, zCreate, zDIORead, zDIOWrite, zRead, zSetEOF, zWrite