다음을 통해 공유

ConnectServerWmi 함수

DCOM 통해 지정된 컴퓨터의 WMI 네임스페이스에 대한 연결을 만듭니다.

참고

이 API는 내부 전용입니다. 개발자 코드에서 사용할 수 없습니다.

구문

HRESULT ConnectServerWmi (
   [in] BSTR               strNetworkResource,
   [in] BSTR               strUser,
   [in] BSTR               strPassword,
   [in] BSTR               strLocale,
   [in] long               lSecurityFlags,
   [in] BSTR               strAuthority,
   [in] IWbemContext*      pCtx,
   [out] IWbemServices**   ppNamespace,
   [in] DWORD              impLevel,
   [in] DWORD              authLevel
);

매개 변수

strNetworkResource
[in] 올바른 WMI 네임스페이스의 개체 경로를 포함하는 유효한 BSTR에 대한 포인터입니다. 자세한 내용은 설명 부분을 참조하세요.

strUser
[in] 사용자 이름이 포함된 유효한 BSTR에 대한 포인터입니다. null 값은 현재 보안 컨텍스트를 나타냅니다. 사용자가 현재 도메인과 다른 도메인에 있는 경우 strUser에는 백슬래시로 구분된 도메인과 사용자 이름도 포함될 수 있습니다. strUser는 userName@domainName과 같은 UPN(사용자 계정 이름) 형식일 수도 있습니다. 자세한 내용은 설명 부분을 참조하세요.

strPassword
[in] 암호가 포함된 유효한 BSTR에 대한 포인터입니다. null은 현재 보안 컨텍스트를 나타냅니다. 빈 문자열("")은 길이가 0인 유효한 암호를 나타냅니다.

strLocale
[in] 정보 검색을 위한 올바른 로캘을 나타내는 유효한 BSTR에 대한 포인터입니다. Microsoft 로캘 식별자의 경우 문자열 형식은 "MS_xxx"입니다. 여기서 xxx는 LCID(로캘 식별자)를 나타내는 16진수 형식의 문자열입니다. 잘못된 로캘이 지정된 경우 이 메서드는 서버의 기본 로캘이 대신 사용되는 Windows 7을 제외하고 WBEM_E_INVALID_PARAMETER를 반환합니다. `null1'이면 현재 로캘이 사용됩니다.

lSecurityFlags
[in] ConnectServerWmi 메서드에 전달할 플래그입니다. 이 매개 변수의 값이 영(0)이면 서버에 대한 연결이 설정된 후에만 ConnectServerWmi에 대한 호출이 반환됩니다. 이로 인해 서버가 손상된 경우 애플리케이션이 무기한 응답하지 않을 수 있습니다. 다른 유효한 값은 다음과 같습니다.

상수 값 Description
CONNECT_REPOSITORY_ONLY 0x40 내부용으로 예약된 속성입니다. 사용하지 마십시오.
WBEM_FLAG_CONNECT_USE_MAX_WAIT 0x80 ConnectServerWmi는 2분 이내에 반환됩니다.

strAuthority
[in] 사용자의 도메인 이름입니다. 다음과 같은 값을 가질 수 있습니다.

값 Description
비어 있음 NTLM 인증이 사용되며 현재 사용자의 NTLM 도메인이 사용됩니다. strUser가 도메인(권장 위치)을 지정하는 경우 여기에 지정해서는 안 됩니다. 두 매개 변수 모두에 도메인을 지정하면 이 함수는 WBEM_E_INVALID_PARAMETER를 반환합니다.
Kerberos:보안 주체 이름 Kerberos 인증이 사용되며 이 매개 변수에는 Kerberos 보안 주체 이름이 포함됩니다.
NTLMDOMAIN:도메인 이름 NT LAN Manager 인증이 사용되며 이 매개 변수에는 NTLM 도메인 이름이 포함됩니다.

pCtx
[in] 일반적으로 이 매개 변수는 null입니다. 그렇지 않으면 하나 이상의 동적 클래스 공급자에 필요한 IWbemContext 개체에 대한 포인터입니다.

ppNamespace
[아웃] 함수가 반환되면 지정된 네임스페이스에 바인딩된 IWbemServices 개체에 대한 포인터를 받습니다. 오류가 발생하면 null을 가리키도록 설정됩니다.

impLevel
[in] 가장 수준입니다.

authLevel
[in] 권한 부여 수준입니다.

반환 값

이 함수가 반환하는 다음 값은 WbemCli.h 헤더 파일에 정의되어 있거나 코드에서 상수로 정의할 수 있습니다.

상수 값 Description
WBEM_E_FAILED 0x80041001 일반적인 오류가 발생했습니다.
WBEM_E_INVALID_PARAMETER 0x80041008 매개 변수가 잘못된 경우
WBEM_E_OUT_OF_MEMORY 0x80041006 메모리가 부족 하 여 작업을 완료할 수 없습니다.
WBEM_S_NO_ERROR 0 함수 호출에 성공했습니다.

설명

이 함수는 IWbemLocator::ConnectServer 메서드에 대한 호출을 래핑합니다.

기본 네임스페이스에 대한 로컬 액세스의 경우 strNetworkResource는 "root\default" 또는 "\.\root\default"와 같은 단순 개체 경로일 수 있습니다. COM 또는 Microsoft 호환 네트워킹을 사용하여 원격 컴퓨터의 기본 네임스페이스에 액세스하려면 컴퓨터 이름 "\myserver\root\default"를 포함합니다. 컴퓨터 이름은 DNS 이름 또는 IP 주소일 수도 있습니다. ConnectServerWmi 함수는 IPv6 주소를 사용하여 IPv6을 실행하는 컴퓨터에도 연결할 수 있습니다.

strUser는 빈 문자열일 수 없습니다. 도메인이 strAuthority에 지정된 경우 strUser에도 포함되어서는 안 됩니다. 그렇지 않으면 함수가 WBEM_E_INVALID_PARAMETER를 반환합니다.

요구 사항

플랫폼:시스템 요구 사항을 참조하세요.

헤더: WMINet_Utils.idl

.NET Framework 버전: 4.7.2부터 사용 가능

참고 항목

  • Last updated on