다음을 통해 공유


SWbemPropertySet.Add 메서드

SWbemPropertySet 개체의 Add 메서드는 SWbemPropertySet 컬렉션에 SWbemProperty 개체를 추가합니다. 동일한 이름의 속성이 컬렉션에 이미 있는 경우 해당 내용이 새 정의로 대체됩니다.

참고

이 작업 후에 추가된 속성의 값은 NULL(할당되지 않음)입니다. WMI 속성의 값을 설정하거나 변경하려면 반환된 SWbemProperty 개체의 Value 속성을 설정해야 합니다.

이 구문에 대한 설명은 스크립팅 API의 문서 규칙을 참조하세요.

구문

objProperty = .Add( _
  ByVal strName, _
  ByVal iCIMType, _
  [ ByVal bIsArray ], _
  [ ByVal iFlags ] _
)

매개 변수

strName [in]

필수 요소. 새 속성의 이름입니다.

iCIMType [in]

필수 요소. 새 속성의 CIMType 한정자를 나타내는 정수입니다. CIMType 한정자 및 해당 값이 있는 목록은 WbemCimTypeEnum을 참조하세요.

bIsArray [in, optional]

속성이 배열 형식인지 여부를 지정합니다. 이 매개 변수의 기본값은 FALSE입니다.

iFlags [in, optional]

예약되어 있으며 지정된 경우 0이어야 합니다.

반환 값

성공하면 이 메서드는 새 속성을 나타내는 SWbemProperty 개체를 반환합니다. 그렇지 않으면 null 개체가 반환됩니다.

오류 코드

Add 메서드가 완료되면 Err 개체에 아래 오류 코드 중 하나가 포함될 수 있습니다.

wbemErrFailed - 2147749889(0x80041001)

지정되지 않은 오류입니다.

wbemErrInvalidParameter - 2147749896(0x80041008)

잘못된 매개 변수가 지정되었습니다.

wbemErrOutOfMemory - 2147749894(0x80041006)

이 메서드를 실행할 메모리가 부족합니다.

wbemErrInvalidPropertyType - 2147749930

CIMType 한정자가 인식되지 않습니다.

예제

이 메서드를 사용하는 코드 예제는 SWbemPropertySet 항목을 참조하세요.

요구 사항

요구 사항
지원되는 최소 클라이언트
Windows Vista
지원되는 최소 서버
Windows Server 2008
헤더
Wbemdisp.h
유형 라이브러리
Wbemdisp.tlb
DLL
Wbemdisp.dll
CLSID
CLSID_SWbemPropertySet
IID
IID_ISWbemPropertySet

추가 정보

SWbemPropertySet

SWbemPropertySet.Remove

SWbemProperty.Value