Win32_NetworkAdapterConfiguration 클래스의 SetGateways 메서드

아티클
11/30/2023

SetGatewaysWMI 클래스 메서드는 네트워크 어댑터가 연결된 서브넷과 다른 서브넷으로 패킷을 라우팅하기 위한 게이트웨이 목록을 지정합니다.

이 항목에서는 MOF(Managed Object Format) 구문을 사용합니다. 이 메서드를 사용하는 방법에 대한 자세한 내용은 메서드 호출을 참조 하세요.

구문

uint32 SetGateways(
  [in]           string DefaultIPGateway[],
  [in, optional] uint16 GatewayCostMetric[]
);

매개 변수

DefaultIPGateway [in]: 네트워크 패킷이 라우팅되는 게이트웨이에 대한 IP 주소 목록입니다.
GatewayCostMetric [in, optional]: 가장 빠르고 신뢰할 수 있는 경로를 계산하는 데 사용되는 1에서 9999 사이의 값을 할당합니다. 이 매개 변수의 값은 DefaultIPGateway 매개 변수의 값에 해당합니다. 게이트웨이의 기본값은 1입니다.

반환 값

다시 부팅이 필요하지 않은 경우 성공적인 완료를 위해 0의 값을 반환하고, 다시 부팅이 필요한 경우 성공적으로 완료하려면 1(1)을 반환하고, 오류가 있는 경우 다른 값을 반환합니다. 오류 코드에 대한 자세한 내용은 WMI 오류 상수 또는 WbemErrorEnum을 참조하세요. 일반적인 HRESULT 값은 시스템 오류 코드를 참조 하세요.

성공적인 완료, 다시 부팅 필요 없음

성공적인 완료, 다시 부팅 필요

이 플랫폼에서 지원되지 않는 메서드

NIC가 DHCP 모드인 경우 메서드가 지원되지 않습니다.

알 수 없는 오류

잘못된 서브넷 마스크

반환된 인스턴스를 처리하는 동안 오류가 발생했습니다.

잘못된 입력 매개 변수

5개 이상의 게이트웨이가 지정됨

잘못된 IP 주소

잘못된 게이트웨이 IP 주소

요청된 정보에 대한 레지스트리에 액세스하는 동안 오류가 발생했습니다.

do기본 이름이 잘못되었습니다.

호스트 이름이 잘못되었습니다.

기본/보조 WINS 서버가 정의되지 않음

잘못된 파일

잘못된 시스템 경로

파일 복사 실패

잘못된 보안 매개 변수

TCP/IP 서비스를 구성할 수 없음

DHCP 서비스를 구성할 수 없음

DHCP 임대를 갱신할 수 없음

DHCP 임대를 해제할 수 없음

어댑터에서 IP를 사용할 수 없음

어댑터에서 IPX를 사용할 수 없음

프레임/네트워크 번호 범위 오류

틀 형식이 잘못되었습니다.

잘못된 네트워크 번호

중복된 네트워크 번호

범위를 벗어난 매개 변수

액세스 거부됨

메모리 부족

이미

경로, 파일 또는 개체를 찾을 수 없음

서비스에 알릴 수 없음

DNS 서비스에 알릴 수 없음

구성할 수 없는 인터페이스

모든 DHCP 임대를 해제/갱신할 수 있는 것은 아닙니다.

어댑터에서 DHCP를 사용할 수 없음

100

기타

101 4294967295

설명

이 메서드는 NIC(네트워크 인터페이스 카드)가 고정 IP 모드인 경우에만 작동합니다.

게이트웨이를 지우려면 EnableStatic에서 사용하는 것과 동일한 IP로 게이트웨이를 설정합니다.

요구 사항

요구 사항	값
지원되는 최소 클라이언트	Windows Vista
지원되는 최소 서버	Windows Server 2008
네임스페이스	Root\CIMV2
MOF	CIMWin32.mof
DLL	CIMWin32.dll

참고 항목

컴퓨터 시스템 하드웨어 클래스
Win32_NetworkAdapterConfiguration
WMI 작업: 네트워킹
WMI 작업: 계정 및 할 일기본
WMI에서의 IPv6 및 IPv4 지원

Win32_NetworkAdapterConfiguration 클래스의 SetGateways 메서드

구문

매개 변수

반환 값

설명

요구 사항

참고 항목

피드백

피드백

추가 리소스