Gets the value of a parameter of an IPv4 address of a NIC on a node.

DWORD lncNicAddr4GetPar( 
    LPCTSTR szNode, 
    DWORD dwNic, 
    DWORD dwAddr, 
    DWORD dwpar, 
    LPDWORD pdwType, 
    LPVOID* ppVal); 

Parameters

szNode

(in) the name of the local node.

dwNic

(in) the number of the NIC.

dwAddr

(in) the number of the address within the NIC.

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_PROP_NFND

there is no address parameter with the number dwPar.

LNCE_READERR

there is a problem reading the configuration file

LNCE_SECTION_NFND

there is no NIC with the number dwNic.

Requirements