value_len
INPUT:BINARY(4)
The length of the value string.
startdir
INPUT:BINARY(4)
The subdirective handle that specifies where to begin searching for a match.
The subdirective immediately following this one is the first one searched. If the
startdir parameter is passed as a NULL (omitted), then searching begins at the
beginning of the subdirective list for maindir. If the startdir parameter is not
NULL, then the maindir parameter can be passed as NULL since the main
directive is implied by startdir. If both the maindir and startdir parameters are
passed, then startdir must be the handle to a subdirective under maindir.
num
INPUT:BINARY(4)
The number of the match to be returned. The num parameter must be a
number greater than or equal to 0. If the value is 0, then the last matching
subdirective is returned. If the value is 1, the first match is returned. If the
value is 2, the second match is returned, and so on.
case_sens
INPUT:BINARY(4)
The value of 0 (false) or a value of 1 (true), indicating whether matching of
tokens in the search string should be case sensitive. In most cases, except
where certain case-sensitive file paths are being considered, this parameter
should be 0 (false). Note that the searches for the actual subdirective name,
which is the first token on the line, is never case-sensitive.
dir
OUTPUT:BINARY(4)
The handle to the matched subdirective, if found.
errcode
I/O:CHAR(*)
The structure in which to return error information.
Error messages
CPF3CF1 E
Error code parameter not valid.
HTPA001 E
Input parameter &1 not valid.
HTPA106 E
Input configuration handle not valid.
HTPA107 E
Input directive handle in parameter &1 not valid.
HTPA108 E
Input directive handle in parameter &1 not a main directive.
HTPA109 E
Input directive handle in parameter &1 not a subdirective.
50 WebProgramming Guide V4R5