다음을 통해 공유

Win32_NetworkAdapterConfiguration 클래스의 EnableStatic 메서드

  • 아티클

EnableStaticWMI 클래스 메서드는 대상 네트워크 어댑터에 대해 정적 TCP/IP 주소 지정을 사용하도록 설정합니다. 따라서 이 네트워크 어댑터에 대한 DHCP를 사용할 수 없습니다.

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

구문

uint32 EnableStatic(
  [in] string IPAddress[],
  [in] string SubnetMask[]
);

매개 변수

IPAddress [in]

현재 네트워크 어댑터의 모든 고정 IP 주소를 나열합니다.

예: 155.34.22.0.

SubnetMask [in]

IPAddress 매개 변수의 값을 보완하는 서브넷 마스크입니다.

예: 255.255.0.0.

반환 값

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

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

0

성공적으로 완료되었습니다. 다시 부팅할 필요가 없습니다.

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

1

성공적으로 완료되고 다시 부팅해야 합니다.

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

64

이 플랫폼에서 지원되지 않는 메서드입니다.

알 수 없는 오류

65

알 수 없는 오류가 발생했습니다.

잘못된 서브넷 마스크

66

잘못된 서브넷 마스크입니다.

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

67

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

잘못된 입력 매개 변수

68

입력 매개 변수가 잘못되었습니다.

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

69

5개 이상의 게이트웨이가 지정되었습니다.

잘못된 IP 주소

70

잘못된 IP 주소입니다.

잘못된 게이트웨이 IP 주소

71

잘못된 게이트웨이 IP 주소입니다.

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

72

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

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

73

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

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

74

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

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

75

기본 또는 보조 WINS 서버가 정의되지 않았습니다.

잘못된 파일

76

파일이 잘못되었습니다.

잘못된 시스템 경로

77

시스템 경로가 잘못되었습니다.

파일 복사 실패

78

파일 복사에 실패했습니다.

잘못된 보안 매개 변수

79

잘못된 보안 매개 변수입니다.

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

80

TCP/IP 서비스를 구성할 수 없습니다.

DHCP 서비스를 구성할 수 없음

81

DHCP 서비스를 구성할 수 없습니다. 자세한 내용은 주의 섹션을 참조하세요.

DHCP 임대를 갱신할 수 없음

82

DHCP 임대를 갱신할 수 없습니다.

DHCP 임대를 해제할 수 없음

83

DHCP 임대를 해제할 수 없습니다.

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

84

어댑터에서 IP를 사용할 수 없습니다.

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

85

어댑터에서 IPX를 사용할 수 없습니다.

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

86

프레임 또는 네트워크 번호 범위 오류입니다.

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

87

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

잘못된 네트워크 번호

88

네트워크 번호가 잘못되었습니다.

중복된 네트워크 번호

89

네트워크 번호가 중복되었습니다.

범위를 벗어난 매개 변수

90

범위를 벗어난 매개 변수입니다.

액세스 거부됨

91

액세스가 거부되었습니다.

메모리 부족

92

메모리가 부족합니다.

이미

93

이미.

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

94

경로, 파일 또는 개체를 찾을 수 없습니다.

서비스에 알릴 수 없음

95

서비스에 알릴 수 없습니다.

DNS 서비스에 알릴 수 없음

96

DNS 서비스에 알릴 수 없습니다.

구성할 수 없는 인터페이스

97

인터페이스를 구성할 수 없습니다.

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

98

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

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

100

어댑터에서 DHCP를 사용할 수 없습니다.

2147786788

쓰기 잠금을 사용할 수 없습니다. 자세한 내용은 INetCfgLock::AcquireWriteLock을 참조하세요.

기타

101 4294967295

설명

EnableStatic을 사용하여 원격 컴퓨터의 IP 주소를 변경하는 경우 해당 어댑터를 통해 연결되는 동안 원격 컴퓨터에 대한 연결이 느슨해지고 사용할 수 없는 RPC 오류 메시지가 표시될 수 있습니다. (그러나 설정이 변경됨). 이 시나리오를 방지하려면 어댑터의 IP 주소를 설정하기 전에 게이트웨이 및/또는 DNS 설정을 변경하는 것이 좋습니다.

EnableStatic을 사용하여 어댑터에 고정 IP 구성을 제공하는 경우 어댑터가 이미 정적 주소로 구성된 경우 함수는 "81 - DHCP 서비스를 구성할 수 없음"을 반환합니다. 그러나 함수는 여전히 새 작업을 사용하여 설정하는 데 성공합니다.

예제

다음 VBScript 샘플에서는 Win32_NetworkAdapterConfiguration 인스턴스에서 DHCP 사용을 사용하지 않도록 설정하는 방법을 보여 줍니다. 이 경우 인덱스가 0인 어댑터를 지정합니다. 다른 인터페이스의 Win32_NetworkAdapter 인스턴스에서 올바른 인덱스를 선택해야 합니다.

참고 항목

이 스크립트는 NT 기반 시스템에만 적용되며, 아래의 ipaddr 및 서브넷 변수를 어댑터에 적용하려는 값으로 변경합니다.

Set Adapter = GetObject("winmgmts:Win32_NetworkAdapterConfiguration=1")

ipaddr = Array("1.1.1.1")
subnet = Array("255.255.255.0")


RetVal = Adapter.EnableStatic(ipaddr,subnet)

if RetVal = 0 then 
 WScript.Echo "DHCP disabled, using static IP address"
else 
 WScript.Echo "DHCP disable failed"
end if

다음 Perl 샘플에서는 Win32_NetworkAdapterConfiguration 인스턴스에서 DHCP 사용을 사용하지 않도록 설정하는 방법을 보여 줍니다. 이 경우 인덱스가 0인 어댑터를 지정합니다. 다른 인터페이스의 Win32_NetworkAdapter 인스턴스에서 올바른 인덱스를 선택해야 합니다.

참고 항목

이 스크립트는 NT 기반 시스템에만 적용되며, 아래의 ipaddr 및 서브넷 변수를 어댑터에 적용하려는 값으로 변경합니다.

use strict;
use Win32::OLE;

my ($Adapter, @ipaddr, @subnet, $RetVal);  
eval { $Adapter = 
 Win32::OLE->GetObject("winmgmts:{impersonationLevel=impersonate}!\\\\.\\root\\cimv2:Win32_NetworkAdapterConfiguration.Index=\"0\""); };

unless ($@) 
{
 push @ipaddr, "192.168.144.107";
 push @subnet, "255.255.255.0";

 $RetVal = $Adapter->EnableStatic(\@ipaddr, \@subnet);

 if ($RetVal == 0) 
 {
  print "\nDHCP disabled, using static IP address\n";
 }
 else 
 {
  print "\nDHCP disable failed\n";
 }
}
else
{
 print STDERR "\n", Win32::OLE->LastError, "\n";
}

요구 사항

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

참고 항목

컴퓨터 시스템 하드웨어 클래스

Win32_NetworkAdapterConfiguration

WMI 작업: 네트워킹

WMI 작업: 계정 및 할 일기본

WMI에서의 IPv6 및 IPv4 지원