WZCEapolGetInterfaceParams function

Article
01/07/2021

[WZCEapolGetInterfaceParams is no longer supported as of Windows Vista and Windows Server 2008. Instead, use the Native Wifi API, which provides similar functionality. For more information, see About the Native Wifi API.]

The WZCEapolGetInterfaceParams function gets EAPOL configuration parameters for the specified wireless LAN interface.

Syntax

DWORD WZCEapolGetInterfaceParams(
  _In_    LPWSTR            pSrvAddr,
  _In_    PWCHAR            pwszGuid,
  _In_    DWORD             dwSizeOfSSID,
  _In_    BYTE              *pbSSID,
  _Inout_ EAPOL_INTF_PARAMS *pIntfParams
);

Parameters

pSrvAddr [in]

A pointer to a string containing the name of the computer on which to execute this function. If this parameter is NULL, then the Wireless Zero Configuration service is called on the local computer.

If the pSrvAddr parameter specified is a remote computer, then the remote computer must support remote RPC calls.

pwszGuid [in]

The GUID of the interface for which data is to be retrieved.

dwSizeOfSSID [in]

The size of the network identifier for which data is to be retrieved.

pbSSID [in]

A pointer to the network identifier for which data is to be retrieved.

pIntfParams [in, out]

A pointer to a EAPOL_INTF_PARAMS structure that contains interface parameters.

Return value

Returns ERROR_SUCCESS if the operation completes successfully; otherwise, returns one of the Windows system error codes.

Remarks

If the WZCEapolGetInterfaceParams returns ERROR_SUCCESS, the caller should call LocalFree to release the internal buffers allocated for the data returned once this information is no longer needed.

Note

The Wzcsapi.h header file and Wzcsapi.lib import library file are not available in the Windows SDK.

Requirements

Requirement	Value
Minimum supported client	Windows XP with SP2 [desktop apps only]
Minimum supported server	Windows Server 2003 [desktop apps only]
End of client support	Windows XP with SP3
End of server support	Windows Server 2003
Header	Wzcsapi.h
Library	Wzcsapi.lib
DLL	Wzcsapi.dll