Gets the value of a parameter for an IPv4 route on a node.

DWORD lncNetRoute4GetPar( 
    LPCTSTR szNode, 
    DWORD dwRoute4, 
    DWORD dwPar, 
    LPDWORD pdwType, 
    LPVOID* ppVal); 

Parameters

szNode

(in) the name of the local node.

dwRoute4

(in) the number of the IPv4 route.

dwPar

(in) the number of the parameter (see parameter values).

pdwType

(out) pointer to a DWORD that is set to the parameter type (REG_DWORD, REG_SZ or REG_MULTI_SZ). If the pointer is NULL, no type is returned.

ppVal

(out) pointer to a DWORD pointer or to a string pointer that is set to the address of the value.

Return values

Zero for success or an error code on failure.

Remarks

The pointer pointed to by ppVal is set to either the address of a DWORD containing the value (if the parameter type is REG_DWORD) or is set to a string pointer (for REG_SZ and REG_MULTI_SZ).

The pointer returned through ppVal is only valid until the next LNC function is called.

Errors

LNCE_PAR_NFND

the parameter number is invalid

LNCE_READERR

the configuration file cannot be read

LNCE_SECTION_NFND

there is no IPv4 route with the number dwRoute4.

Requirements