Remove NetWare Authentication Entry (QfpzRmvNtwAutE) API


  Required Parameter Group:

1 Entry identifier data Input Char(*)
2 Length of entry identifier Input Binary(4)
3 Entry identifier format name Input Char(8)
4 Error code I/O Char(*)

  Default Public Authority: *USE

  Library Name/Service Program: QFPNTWE/QFPZAAPI

  Threadsafe: No

The Remove NetWare Authentication Entry (QfpzRmvNtwAutE) API removes an authentication entry from the user profile.


Authorities and Locks

User Profile Authority
The user profile must be the current user profile, or the caller must have *USE and *OBJMGT authority to the user profile and *SECADM special authority.

Required Parameter Group

Entry identifier data
INPUT; CHAR(*)

The authentication entry to be removed. The content and format of this structure is determined by the format name. See Format of Authentication Entry Identifier for a description of these formats.

Length of entry identifier
INPUT; BINARY(4)

The length of the authentication entry identifier structure.

Entry identifier format name
INPUT; CHAR(8)

The content and format of the authentication entry identifier data. Each format corresponds to a method of identifying an authentication entry.

The possible format names follow:

AUTE0100 The NetWare Version 3.x server entry is identified by the server name.
AUTE0200 The NetWare Directory Services tree entry is identified by the NDS tree name.
AUTE0900 All authentication entries are removed from a user profile.

Error code
I/O; CHAR(*)

The structure in which to return error information. For the format of the structure, see Error Code Parameter.



Format of Authentication Entry Identifier

For details about the format of the entry identifier data, see the following sections. For details about the fields in each format, see Field Descriptions.

AUTE0100 Format

Offset Type Field
Dec Hex
0 0 BINARY(4) Offset to server name
4 4 BINARY(4) Length of server name
8 8 CHAR(10) User profile name
18 12 CHAR(6) Reserved
    CHAR(*) Server name


AUTE0200 Format

Offset Type Field
Dec Hex
0 0 BINARY(4) Offset to NDS tree name
4 4 BINARY(4) Length of NDS tree name
8 8 CHAR(10) User profile name
18 12 CHAR(6) Reserved
    CHAR(*) NDS tree name


AUTE0900 Format

Offset Type Field
Dec Hex
0 0 CHAR(10) User profile name
10 A CHAR(6) Reserved


Field Descriptions

Length of NDS tree name. The length, in bytes, of the NDS tree name.

Length of server name. The length, in bytes, of the server name.

NDS tree name. For *NDS tree entries, the name of the directory tree.

Offset to NDS tree name. The offset, in bytes, from the start of the input data area to the NDS tree name.

Offset to server name. The offset, in bytes, from the start of the input data area to the server name.

Reserved. Set this field to binary zeros.

Server name. For *NETWARE3 entries, the name of the server.

User profile name. The name of the user profile that contains the authentication entry.

You can use the following special value for the user profile name:

*CURRENT The current user profile.

Error Messages

Message ID Error Message Text
CPF2204 E User profile &1 not found.
CPF2217 E Not authorized to user profile &1.
CPF24B4 E Severe error while addressing parameter list.
CPF3C1D E Length specified in parameter &1 not valid.
CPF3C21 E Format name &1 is not valid.
CPF3C90 E Literal value cannot be changed.
CPF3CF1 E Error code parameter not valid.
CPF9872 E Program or service program &1 in library &2 ended. Reason code &3.
FPE0211 E Parameter length &1 not valid for field &2.
FPE0212 E Field offset and length not within data.
FPE0215 E Could not find authentication entry for &1.

API introduced:

Top | Security APIs | APIs by category