|
|
|
|
An application uses this verb to release its handle to the domain configuration file, or to the sna.net file, when it has finished issuing NOF verbs to the file. The file which the application wishes to close is identified by the target_handle parameter on the call.
The application should always issue CLOSE_FILE for any open file handles before it exits. After the verb completes successfully, the target handle identifying the file is no longer valid.
This verb must be issued to the domain configuration fileor to the sna.net file.
typedef struct close_file
{
AP_UINT16 opcode; /* verb operation code */
unsigned char reserv2 /* reserved */
unsigned char format; /* reserved */
AP_UINT16 primary_rc; /* primary return code */
AP_UINT32 secondary_rc; /* secondary return code */
} CLOSE_FILE;
The application supplies the following parameters:
If the verb executes successfully, SNAP-IX returns the following parameters:
AP_OK
Not used.
If the verb does not execute because of a state check, SNAP-IX returns the following parameters:
AP_STATE_CHECK
The specified file cannot be released because a previous verb issued for this target handle is still outstanding. All verbs for the target file must be completed before attempting to close the file.
Common Return Codes lists further secondary return codes associated with AP_STATE_CHECK, which are common to all NOF verbs.
Common Return Codes lists further combinations of primary and secondary return codes that are common to all NOF verbs.
|
|
|
 |
|