GetNetworkParams (Compact 2013)
3/26/2014
This function retrieves network parameters for the local device.
Syntax
DWORD GetNetworkParams(
PFIXED_INFO pFixedInfo,
PULONG pOutBufLen
);
Parameters
- pFixedInfo
[out] A pointer to a buffer that contains a FIXED_INFO structure that receives the network parameters for the local device, if the function was successful. This buffer must be allocated by the caller.
- pOutBufLen
[in, out] A pointer to a ULONG variable that specifies the size of the FIXED_INFO structure. If this size is insufficient to hold the information, GetNetworkParams fills in this variable with the required size, and returns an error code of ERROR_BUFFER_OVERFLOW.
Return Value
Return code |
Description |
---|---|
ERROR_SUCCESS |
The function succeeds. |
ERROR_BUFFER_OVERFLOW |
The buffer to receive the network parameter information is too small. This value is returned if the pOutBufLen parameter is too small to hold the network parameter information or the pFixedInfo parameter was a NULL pointer. When this error code is returned, the pOutBufLen parameter points to the required buffer size. |
ERROR_INVALID_PARAMETER |
An invalid parameter was passed to the function. This error is returned if the pOutBufLen parameter is a NULL pointer, the calling process does not have read/write permission to the memory pointed to by pOutBufLen, or the calling process does not have write access to the memory pointed to by the pFixedInfo parameter. |
ERROR_NO_DATA |
No network parameter information exists for the local device. |
ERROR_NOT_SUPPORTED |
GetNetworkParams is not supported by the operating system that is running on the local device. |
Other |
If the function fails, use FormatMessage to obtain the message string for the returned error. |
Requirements
Header |
iphlpapi.h |
Library |
Iphlpapi.lib |
See Also
Reference
IP Helper Functions
FIXED_INFO