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 |
헤더 |
|
유형 라이브러리 |
|
DLL |
|
CLSID |
CLSID_SWbemPropertySet |
IID |
IID_ISWbemPropertySet |