| 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(*) |
The Verify NetWare Authentication Entry (QfpzVfyNtwAutE) API verifies that the specified authentication entry can be used to connect to a server. The user name, password, and other data are sent to the server, where they are used to attempt to start an authenticated connection to the server. This API might be used, for example, to verify that the password is valid before submitting a batch job that would use this entry.
The server and user name for the connection to be started. The content and format of this structure are determined by the format name. See Format of Authentication Entry Identifier for a description of these formats.
The length of the entry identifier structure.
The content and format of the input 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. |
The structure in which to return error information. For the format of the structure, see Error Code Parameter.
For details about the format of the entry identifier, see the following sections. For details about the fields in each format, see Field Descriptions.
| 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 | ||
| 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 | BINARY(4) | Offset to server name |
| 12 | C | BINARY(4) | Length of server name |
| 16 | 10 | CHAR(10) | User profile name |
| 26 | 1A | CHAR(6) | Reserved |
| CHAR(*) | NDS tree name | ||
| CHAR(*) | Server name | ||
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 trees, 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.
Server name. For *NETWARE3 servers, the name of the server.
For *NDS servers, the name of the server on which to verify the authentication entry.
For *NDS servers, the following special value may be specified:
| *ANY | Any server in the specified NDS tree. |
Reserved. Set this field to binary zeros.
User profile name. The name of the user profile that contains the authentication entry.
You can use the following special values for the object name:
| *CURRENT | The current user profile. |
| 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. |
| FPE021C E | Not able to contact server &1. |
| FPE0235 E | Error &2 connecting to server &3. |
| FPE023C E | Server is not a &2 server. Server: &1. |
| FPE023D E | NDS tree not known to system. Tree: &1. |
| FPE023E E | Server &1 not found in tree &2. |
| Top | Security APIs | APIs by category |