목차 페이지로 돌아가기

구성 업데이트: Intel(R) PRO Network Adapters WMI and CDM Providers 사용 설명서

개요
어댑터, 팀 또는 VLAN 설정 변경
새 (빈) 팀 만들기
팀에 어댑터 추가
팀에서 어댑터 제거
팀 삭제
팀 모드 변경
팀 내의 어댑터 우선 순위 변경
어댑터 제거
VLAN 만들기
VLAN 속성 변경
VLAN 삭제
Boot Agent 업데이트


개요

대부분의 경우 구성을 업데이트하려면 클라이언트 응용 프로그램에서 IANet_NetService 클래스의 세션 핸들을 가져와서 IWbemContext 컨텍스트 객체에 저장해야 합니다. 구성 변경은 IANet_NetService에서 Apply 메서드가 호출될 때만 발생합니다. 이 요구 사항에는 다음 몇 가지 예외가 따릅니다.

일부 작업의 경우 컨텍스트에서 PreCheck 한정자를 사용하여 해당 작업이 허용되는지 확인할 수 있습니다. 이는 필요한 경우 사용자 인터페이스에서 특정 컨트롤이나 메뉴 항목을 비활성화할 수 있도록 하기 위한 것입니다.

맨 처음으로 돌아가기


어댑터, 팀 또는 VLAN 설정 변경

어댑터, 팀 또는 VLAN을 변경할 경우

어댑터, VLAN 또는 팀 설정을 변경하려면 먼저 클라이언트가 변경할 설정의 객체 경로를 가져와야 합니다. 객체의 설정을 열거한 다음 해당 설정의 __PATH 속성을 저장하는 것이 이 작업에 가장 좋은 방법입니다(위 내용 참조).

클라이언트가 가장 쉽게 설정을 업데이트할 수 있는 방법은 다음과 같습니다.

  1. WMI에서 설정 객체의 인스턴스를 가져옵니다.
  2. CurrentValue 속성을 수정합니다(IWbemClassObject::Put() 사용).
  3. IWbemServices::PutInstance()를 호출하여 수정된 인스턴스를 WMI Provider에 다시 전달합니다. PutInstance는 WBEM_FLAG_UPDATE_ONLY 플래그를 사용하여 호출해야 합니다.

WMI Provider는 CurrentValue를 검증하고 검증이 실패한 경우 WBEM_E_FAIL을 반환합니다. 정확한 실패 이유는 IANet_ExtendedStatus 객체의 Description 속성에서 반환됩니다.

설정별 설명은 다음을 포함합니다.

마지막 설명은 IANet_SettingEnum, IANet_SettingSlider 또는 IANet_SettingMultiSelection의 현재 값이 허용되는 값 중 하나가 아닐 때 반환됩니다.

클라이언트가 변경할 수 있는 설정의 속성은 CurrentValue뿐입니다. WMI Provider는 다른 모든 값의 변경 사항을 무시합니다.

설정 클래스에 대해 지원되는 메서드가 없습니다. 설정을 변경하려면 CurrentValue 속성을 수정하고 PutInstance를 호출하십시오.

맨 처음으로 돌아가기


새 (빈) 팀 만들기

새 팀을 만들 경우

새 팀을 만들려면 IANet_TeamOfAdapters 인스턴스를 만드십시오. 즉, IWbemServices::GetObject()를 사용하여 IANet_TeamOfAdapters의 클래스 객체를 가져온 다음 IWbemServices::SpawnInstance()를 사용하여 이 객체의 인스턴스를 만드십시오.

그런 다음 IWbemClassObject::Put을 사용하여 인스턴스의 TeamMode 속성을 원하는 팀 유형(예: AFT)으로 설정하십시오. 마지막으로 IWbemServices::PutInstance()를 호출하여 팀을 만들면서 WBEM_FLAG_CREATE_ONLY 플래그를 전달하십시오.

새 팀의 객체 경로는 호출 완료 시 다시 전달되는 IWbemCallResultObject에 저장됩니다. IWbemCallResult::GetResultString 메서드는 새 객체 경로를 가져옵니다.

이 작업이 실패한 경우 클라이언트는 IANet_ExtendedStatus를 검사하여 실패 이유를 확인해야 합니다.

팀의 가상 IANet_EthernetAdapter 및 IANet_IPProtocolEndpoint 클래스는 Apply를 호출한 후에야 사용할 수 있습니다. 새 IANet_TeamOfAdapters와 연관된 IANet_Configuration 객체를 사용하여 팀 설정에 액세스할 수 있습니다.

맨 처음으로 돌아가기


팀에 어댑터 추가

팀에 어댑터를 추가할 경우

팀에 어댑터를 추가하려면 IANet_TeamedMemberAdapter 인스턴스를 만드십시오. 즉, IWbemServices::GetObject()를 사용하여 IANet_TeamedMemberAdapter의 클래스 객체를 가져온 다음 IWbemServices::SpawnInstance()를 사용하여 이 객체의 인스턴스를 만드십시오.

IWbemClassObject::Put()을 사용하여 객체의 다음 속성을 설정해야 합니다.

팀 내의 어댑터 우선 순위도 설정할 수 있습니다. 마지막으로, IWbemServices::PutInstance()를 호출하여 팀에 어댑터를 추가하여 WBEM_FLAG_CREATE_ONLY 플래그를 전달하십시오. 이 작업이 실패한 경우 IANet_ExtendedStatus에서 오류 코드를 검사하십시오.

맨 처음으로 돌아가기


팀에서 어댑터 제거

팀에서 어댑터를 제거할 경우

팀에서 어댑터를 제거하려면 IWbemServices::DeleteInstance()를 사용하여 어댑터를 팀에 연관시키는 IANet_TeamedMemberAdapter 인스턴스를 삭제하십시오. 이 작업이 실패한 경우 IANet_ExtendedStatus에서 오류 코드를 검사하십시오.

맨 처음으로 돌아가기


팀 삭제

팀을 삭제할 경우

팀을 삭제하려면 IWbemServices::DeleteInstance()를 사용하여 IANet_TeamOfAdapters 인스턴스를 삭제하십시오. 이 작업이 실패한 경우 IANet_ExtendedStatus에서 오류 코드를 검사하십시오.

맨 처음으로 돌아가기


팀 모드 변경

팀 모드를 변경할 경우

팀 모드를 변경하려면 팀의 IANet_TeamOfAdapters 인스턴스를 가져오십시오. 예를 들어, 팀의 객체 경로를 사용하는 IWbemServices::GetObject를 사용하십시오. 그런 다음 IWbemClassObject::Put을 사용하여 팀의 TeamMode 속성을 변경하십시오. 마지막으로, IWbemClassObject:: PutInstance를 호출하여 팀 모드를 변경하여 WBEM_FLAG_UPDATE_ONLY 플래그를 전달하십시오. 이 작업이 실패한 경우 IANet_ExtendedStatus에서 오류 코드를 검사하십시오.

맨 처음으로 돌아가기


팀 내의 어댑터 우선 순위 변경

팀 내의 어댑터 우선 순위를 변경할 경우

어댑터 우선 순위를 변경하려면 먼저 클라이언트가 어댑터의 IANet_TeamedMemberAdapter 인스턴스를 가져와야 합니다. 예를 들어, 객체 경로를 사용하는 IWbemServices::GetObject를 사용하십시오. 그런 다음 클라이언트가 IWbemClassObject::Put을 사용하여 어댑터의 AdapterFunction 속성을 변경할 수 있습니다. 마지막으로 클라이언트가 IWbemClassObject:: PutInstance를 호출하여 어댑터 우선 순위를 업데이트해야 합니다. 이 작업이 실패한 경우 클라이언트는 IANet_ExtendedStatus에서 오류 코드를 검사해야 합니다.

맨 처음으로 돌아가기


어댑터 제거

어댑터를 제거할 경우

어댑터를 제거하려면 IWbemServices::DeleteInstance를 호출하여 제거할 어댑터의 객체 경로를 전달하십시오.

맨 처음으로 돌아가기


VLAN 만들기

VLAN을 만들 경우

VLAN을 만들려면 VLAN이 추가될 어댑터의 IANet_802dot1QVLANService에서 CreateVLAN 메서드를 호출하십시오. 다음 인수를 메서드에 전달해야 합니다.

이 함수는 출력 매개변수 VLANpath에서 새로 만든 VLAN의 객체 경로를 반환합니다. 이 작업이 실패한 경우 IANet_ExtendedStatus에서 오류 코드를 검사하십시오.

맨 처음으로 돌아가기


VLAN 속성 변경

VLAN 속성을 변경할 경우

클라이언트는 VLAN의 VLANNumber 및 VLANName 속성을 변경할 수 있습니다. 어댑터 우선 순위를 변경하려면 먼저 어댑터의 IANet_VLAN 인스턴스를 가져오십시오. 예를 들어, 객체 경로를 사용하는 IWbemServices::GetObject를 사용하십시오.

그런 다음 VLANNumber 또는 VLANName을 원하는 값으로 변경하십시오. 마지막으로 IWbemClassObject:: PutInstance를 호출하여 속성을 업데이트하여 WBEM_FLAG_UPDATE_ONLY 플래그를 전달하십시오. 이 작업이 실패한 경우 IANet_ExtendedStatus에서 오류 코드를 검사하십시오.

맨 처음으로 돌아가기


VLAN 삭제

VLAN을 삭제할 경우

VLAN을 삭제하려면 IWbemServices::DeleteInstance를 호출하여 삭제할 VLAN의 객체 경로를 전달하십시오.

맨 처음으로 돌아가기


Boot Agent 업데이트

Boot Agent를 업데이트할 경우

클라이언트는 메서드 호출을 사용하여 Boot Agent 이미지를 업데이트할 수 있습니다. 플래시 이미지를 읽거나 쓰려면 먼저 어댑터의 IANet_BootAgent 인스턴스를 가져오십시오. 예를 들어, 객체 경로를 사용하는 IWbemServices::GetObject를 사용하십시오.

그런 다음 ReadFlash()를 실행하여 기존 플래시 부트 ROM 이미지를 읽거나 ProgramFlash()를 실행하여 플래시 부트 ROM 이미지를 업데이트하십시오. 이 작업이 실패한 경우 IANet_ExtendedStatus에서 오류 코드를 검사하십시오.

 
작업 WMI 메서드 결과 설명
어댑터의 부트 ROM 이미지 업데이트 또는 삽입 uint32 ProgramFlash(
                           [IN,
          ValueMap {"0","1"} ,
          Values {"Check Version", "Write Flash"}: Amended
                           ]
                           uint32 Action,
                           [IN]
                           uint8 NewFlashData[],
                           [OUT]
                           string strErrorMessage
                           );
'버전 검사' 작업이 지정된 경우 NewFlashData[]에서 업데이트 중인 부트 ROM 이미지가 이미 NIC에 있는 이미지보다 오래된 것이면 경고 메시지가 반환됩니다.

'쓰기' 작업이 지정된 경우에는 NIC에 있는 플래시 ROM이 NewFlashData[]로 업데이트됩니다.

이 메서드는 NIC에서 플래시 ROM을 업데이트하는 데 사용됩니다. 이 메서드를 사용하면 플래시가 업데이트되는 동안 NIC와 네트워크 간의 통신이 중지됩니다.
부트 ROM 이미지 읽기 uint32 ReadFlash( [OUT] uint8
FlashData[] );
FlashData[]는 NIC에 있는 플래시 ROM 이미지를 포함합니다. 이 메서드는 NIC에 있는 플래시 ROM(파일에 저장할 수 있음)을 읽습니다.


제한 및 책임 부인을 자세히 읽어보십시오.


목차 페이지로 돌아가기     맨 처음으로 돌아가기