zNewConnectionWithBlob

Creates a connection to NSS as the specified user along with the user specified data in the connection.

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

Syntax

#include <zPublics.h>

STATUS zNewConnection(
   Key_t            rootkey,
   const unicode_t  *fdn)
   NINT            length,
   const BYTE      *blob);

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.

length

(IN) Specifies the length (in bytes) of the blob data.

blob

(IN) User interested data, the same is passed to the audit events.

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