WZCRefreshInterface 함수

[WZCRefreshInterface 는 Windows Vista 및 Windows Server 2008을 기준으로 지원되지 않습니다. 대신 비슷한 기능을 제공하는 네이티브 Wifi API를 사용합니다. 자세한 내용은 네이티브 Wifi API 정보를 참조하세요.]

WZCRefreshInterface 함수는 특정 무선 LAN 인터페이스에 대한 인터페이스 정보를 새로 고칩니다.

구문

DWORD WZCRefreshInterface(
  _In_  LPWSTR      pSrvAddr,
  _In_  DWORD       dwInFlags,
  _In_  PINTF_ENTRY pIntf,
  _Out_ LPDWORD     pdwOutFlags
);

매개 변수

pSrvAddr [in]

이 함수를 실행할 컴퓨터의 이름을 포함하는 문자열에 대한 포인터입니다. 이 매개 변수가 NULL이면 로컬 컴퓨터에서 무선 제로 구성 서비스가 호출됩니다.

지정된 pSrvAddr 매개 변수가 원격 컴퓨터인 경우 원격 컴퓨터는 원격 RPC 호출을 지원해야 합니다.

dwInFlags [in]

수행할 특정 새로 고침 작업과 함께 새로 고칠 필드 집합입니다. 다음 플래그의 조합을 포함할 수 있는 비트 마스크입니다.

값	의미
INTF_DESCR 0x00010000	무선 LAN 인터페이스에 대한 인터페이스 설명을 새로 고칩니다. 새로 고친 인터페이스 설명은 dwInFlags 매개 변수에 설정된 INTF_DESCR 비트로 WZCQueryInterface 함수를 호출하여 검색할 수 있습니다. 인터페이스 설명은 WZCQueryInterface 함수에서 반환되는 pIntf 매개 변수가 가리키는 INTF_ENTRY 구조체의 wszDescr 멤버에서 반환됩니다.
INTF_NDISMEDIA 0x00020000	무선 LAN 인터페이스에 대한 NDIS 미디어 정보를 새로 고칩니다. 새로 고친 NDIS 미디어 정보는 dwInFlags 매개 변수에 설정된 INTF_NDISMEDIA 비트로 WZCQueryInterface 함수를 호출하여 검색할 수 있습니다. NDIS 미디어 정보는 WZCQueryInterface 함수에서 반환되는 pIntf 매개 변수가 가리키는 INTF_ENTRY 구조체의 ulMediaState, ulMediaType 및 ulPhysicalMediaType 멤버에 반환됩니다.
INTF_ALL_OIDS 0xFFF00000	무선 LAN 인터페이스에 대한 모든 NDIS OID를 새로 고칩니다. 이 옵션은 무선 LAN 인터페이스에 대한 대부분의 데이터를 새로 고칩니다. 새로 고친 정보는 WZCQueryInterface 함수를 호출하여 검색할 수 있습니다.

 

pIntf [in]

새로 고칠 인터페이스의 키를 포함하는 INTF_ENTRY 구조체에 대한 포인터입니다.

pdwOutFlags [out]

성공적으로 새로 고친 필드 집합입니다.

반환 값

함수가 성공하면 반환 값이 ERROR_SUCCESS.

함수가 실패하면 반환 값은 다음 반환 코드 중 하나일 수 있습니다.

반환 코드	설명
ERROR_ARENA_TRASHED	스토리지 제어 블록이 제거되었습니다. 무선 제로 구성 서비스가 내부 개체를 초기화하지 않은 경우 이 오류가 반환됩니다.
ERROR_FILE_NOT_FOUND	시스템은 지정된 파일을 찾을 수 없습니다. pIntf 매개 변수가 가리키는 INTF_ENTRY 구조체의 wszGuid 멤버의 GUID가 로컬 컴퓨터의 무선 LAN 인터페이스와 일치하지 않으면 이 오류가 반환됩니다.
ERROR_INVALID_PARAMETER	매개 변수가 잘못되었습니다. pIntf 매개 변수가 NULL인 경우 이 오류가 반환됩니다. 이 오류는 pIntf 매개 변수가 가리키는 INTF_ENTRY 구조체의 wszGuid 멤버가 NULL인 경우 반환됩니다.
RPC_STATUS	다양한 오류 코드.

 

설명

pIntf 매개 변수가 가리키는 INTF_ENTRY 구조체의 wszGuid 멤버에는 무선 LAN 인터페이스에 대한 인터페이스 GUID가 포함되어야 합니다. WZCEnumInterfaces 함수를 호출하여 무선 LAN 인터페이스 목록을 검색할 수 있습니다.

참고

Wzcsapi.h 헤더 파일 및 Wzcsapi.lib 가져오기 라이브러리 파일은 Windows SDK에서 사용할 수 없습니다.

 

요구 사항

요구 사항	값
지원되는 최소 클라이언트	WINDOWS XP SP2 [데스크톱 앱만 해당]
지원되는 최소 서버	Windows Server 2003 [데스크톱 앱만 해당]
클라이언트 지원 종료	Windows XP with SP3
서버 지원 종료	Windows Server 2003
헤더	Wzcsapi.h
라이브러리	Wzcsapi.lib
DLL	Wzcsapi.dll

추가 정보

WZCEapolGetInterfaceParams

WZCEnumInterfaces

WZCQueryInterface

INTF_ENTRY