Gets the value of a Kernel parameter

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

Parameters

szNode

(in) the name of the local node.

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_READERR

there is a problem reading the configuration file

LNCE_PAR_NFND

the parameter number is invalid

LNCE_NUMPROC

(for LNCE_NINTIMECORES) the NUMPROC boot parameter is invalid

Requirements