SWbemNamedValueSet 개체

SWbemNamedValueSet 개체는 SWbemNamedValue 개체의 컬렉션입니다. SWbemNamedValueSet의 메서드 및 속성은 WMI에 특정 호출을 제출할 때 공급자에게 더 많은 정보를 보내는 데 주로 사용됩니다. SWbemServices의 모든 호출과 SWbemObject의 일부 호출은 이 형식의 개체인 선택적 매개 변수를 사용합니다. 클라이언트는 SWbemNamedValueSet 개체에 정보를 추가하고 호출을 매개 변수 중 하나로 사용하여 SWbemNamedValueSet 개체를 보낼 수 있습니다. 이 개체는 VBScript CreateObject 호출로 만들 수 있습니다.

자세한 내용은 컬렉션 액세스를 참조하세요.

SWbemNamedValueSet 개체는 SWbemNamedValue 요소의 컬렉션입니다. 이러한 항목은 SWbemNamedValueSet.Add 메서드를 사용하여 컬렉션에 추가됩니다. 또한 SWbemNamedValueSet.Remove 메서드를 사용하여 제거되고 SWbemNamedValueSet.Item 메서드를 사용하여 검색됩니다. 메서드에 액세스하여 동적 공급자에 필요한 컨텍스트 정보를 입력할 수 있습니다. SWbemServices 메서드 중 하나를 호출한 후 다른 호출에 SWbemNamedValueSet 개체를 다시 사용할 수 있습니다.

기본 공급자는 SWbemNamedValueSet 개체에 포함된 정보를 결정합니다. WMI는 정보를 사용하지 않고 공급자에게 전달하기만 합니다. 공급자는 서비스 요청에 필요한 컨텍스트 정보를 게시해야 합니다.

멤버

SWbemNamedValueSet 개체에는 다음과 같은 형식의 멤버가 있습니다.

• 메서드
• 속성

메서드

SWbemNamedValueSet 개체에는 다음과 같은 메서드가 있습니다.

속성

SWbemNamedValueSet 개체에는 다음과 같은 속성이 있습니다.

예제

다음 VBScript 샘플에서는 명명된 값이 배열 형식인 경우 명명된 값 집합의 조작을 보여줍니다.

Set Context = CreateObject("WbemScripting.SWbemNamedValueSet")

On Error Resume Next

Context.Add "n1", Array (1, 2, 3)
str = "The initial value of n1 is {"
for x=LBound(Context("n1")) to UBound(Context("n1"))
 str = str & Context("n1")(x)
 if x <> UBound(Context("n1")) Then
  str = str & ", "
 End if
next
str = str & "}"
WScript.Echo str

WScript.Echo ""

' report the value of an element of the context value
v = Context("n1")
WScript.Echo "By indirection the first element of n1 has value:",v(0)

' report the value directly
WScript.Echo "By direct access the first element of n1 has value:", Context("n1")(0)

' set the value of a single named value element
Context("n1")(1) = 11 
WScript.Echo "After direct assignment the first element of n1 has value:", Context("n1")(1)

' set the value of a single named value element
Set v = Context("n1")
v(1) = 345
WScript.Echo "After indirect assignment the first element of n1 has value:", Context("n1")(1)

' set the value of an entire context value
Context("n1") = Array (5, 34, 178871)
WScript.Echo "After direct array assignment the first element of n1 has value:", Context("n1")(1)

str = "After direct assignment the entire value of n1 is {"
for x=LBound(Context("n1")) to UBound(Context("n1"))
 str = str & Context("n1")(x)
 if x <> UBound(Context("n1")) Then
  str = str & ", "
 End if
next
str = str & "}"
WScript.Echo str

if Err <> 0 Then
 WScript.Echo Err.Description
 Err.Clear
End if

다음 Perl 샘플에서는 명명된 값이 배열 형식인 경우 명명된 값 집합의 조작을 보여줍니다.

use strict;
use Win32::OLE;

my ( $Context, $str, $x, @v);

eval {$Context = new Win32::OLE 'WbemScripting.SWbemNamedValueSet'; };
unless($@)
{
 $Context->Add("n1", [1, 2, 3]);
 $str = "The initial value of n1 is {";
 for ($x = 0; $x < @{$Context->Item("n1")->{Value}}; $x++)
 {
  $str = $str.@{$Context->Item("n1")->{Value}}[$x];
  if ($x != (@{$Context->Item("n1")->{Value}}) - 1 )
  {
   $str = $str.", ";
  }
 }
 $str = $str."}";
 print $str,"\n\n";

 # report the value of an element of the context value
 @v = @{$Context->Item("n1")->{Value}};
 print "By indirection the first element of n1 has value:", $v[0], "\n";

 # report the value directly
 print "By direct access the first element of n1 has value:", @{$Context->Item("n1")->{Value}}[0], "\n";

 # set the value of a single named value element
 @{$Context->Item("n1")->{Value}}[1] = 11;
 print "After direct assignment the first element of n1 has value:", 
       @{$Context->Item("n1")->{Value}}[1], "\n";

 # set the value of a single named value element
 @v = @{$Context->Item("n1")->{Value}};
 $v[1] = 345;
 print "After indirect assignment the first element of n1 has value:", 
    @{$Context->Item("n1")->{Value}}[1], "\n";

 # set the value of an entire context value
 $Context->Item("n1")->{Value} = [5, 34, 178871];
 print "After direct array assignment the first element of n1 has value:", 
   @{$Context->Item("n1")->{Value}}[1], "\n";

 $str = "After direct assignment the entire value of n1 is {";
 for ($x = 0; $x < @{$Context->Item("n1")->{Value}}; $x++)
 {
  $str = $str.@{$Context->Item("n1")->{Value}}[$x];
  if ($x != (@{$Context->Item("n1")->{Value}}) - 1 )
  {
   $str = $str.", ";
  }
 }
 $str = $str."}";
 print $str,"\n";
}
else
{
 print STDERR Win32::OLE->LastError, "\n";
}

요구 사항

추가 정보

스크립팅 API 개체