ConnectServerWmi, funkcja

Tworzy połączenie za pośrednictwem modelu DCOM z przestrzenią nazw WMI na określonym komputerze.

Składnia

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
);

Parametry

strNetworkResource
[w] Wskaźnik prawidłowy BSTR zawierający ścieżkę obiektu poprawnej przestrzeni nazw usługi WMI. Aby uzyskać więcej informacji, zobacz sekcję Uwagi .

strUser
[w] Wskaźnik prawidłowy BSTR zawierający nazwę użytkownika. Wartość null wskazuje bieżący kontekst zabezpieczeń. Jeśli użytkownik pochodzi z innej domeny niż bieżąca, strUser może również zawierać domenę i nazwę użytkownika oddzieloną ukośnikiem odwrotnym. strUser może być również w formacie głównej nazwy użytkownika (UPN), takim jak userName@domainName. Aby uzyskać więcej informacji, zobacz sekcję Uwagi .

strPassword
[w] Wskaźnik do prawidłowego BSTR hasła. A null wskazuje bieżący kontekst zabezpieczeń. Pusty ciąg ("") wskazuje prawidłowe hasło o zerowej długości.

strLocale
[w] Wskaźnik prawidłowy BSTR , który wskazuje poprawne ustawienia regionalne pobierania informacji. W przypadku identyfikatorów ustawień regionalnych firmy Microsoft format ciągu to "MS_xxx", gdzie xxx jest ciągiem w postaci szesnastkowej, która wskazuje identyfikator ustawień regionalnych (LCID). Jeśli określono nieprawidłowe ustawienia regionalne, metoda zwraca WBEM_E_INVALID_PARAMETER wartość z wyjątkiem systemu Windows 7, gdzie są używane domyślne ustawienia regionalne serwera. Jeśli wartość null1, używane są bieżące ustawienia regionalne.

lSecurityFlags
[w] Flagi, które mają być przekazywane do ConnectServerWmi metody. Wartość zero (0) dla tego parametru powoduje zwrócenie wywołania ConnectServerWmi tylko po nawiązaniu połączenia z serwerem. Może to spowodować, że aplikacja nie odpowiada na czas nieokreślony, jeśli serwer zostanie uszkodzony. Pozostałe prawidłowe wartości to:

strAuthority
[w] Nazwa domeny użytkownika. Może mieć następujące wartości:

pCtx
[w] Zazwyczaj ten parametr to null. W przeciwnym razie jest to wskaźnik do obiektu IWbemContext wymaganego przez co najmniej jednego dostawcę klas dynamicznych.

ppNamespace
[out] Po powrocie funkcji otrzymuje wskaźnik do obiektu IWbemServices powiązanego z określoną przestrzenią nazw. Jest ona ustawiona tak, aby null wskazywała, gdy wystąpi błąd.

impLevel
[w] Poziom personifikacji.

authLevel
[w] Poziom autoryzacji.

Wartość zwracana

Następujące wartości zwracane przez tę funkcję są zdefiniowane w pliku nagłówka WbemCli.h lub można je zdefiniować jako stałe w kodzie:

Uwagi

Ta funkcja opakowuje wywołanie metody IWbemLocator::ConnectServer .

W przypadku dostępu lokalnego do domyślnej przestrzeni nazw strNetworkResource może być prosta ścieżka obiektu: "root\default" lub "\.\root\default". Aby uzyskać dostęp do domyślnej przestrzeni nazw na komputerze zdalnym przy użyciu sieci COM lub zgodnej z firmą Microsoft, dołącz nazwę komputera: "\myserver\root\default". Nazwa komputera może być również nazwą DNS lub adresem IP. Funkcja ConnectServerWmi może również łączyć się z komputerami z uruchomionym protokołem IPv6 przy użyciu adresu IPv6.

strUser nie może być pustym ciągiem. Jeśli domena jest określona w strAuthorityelemencie , nie może być również uwzględniona w strUserelemencie , lub funkcja zwraca wartość WBEM_E_INVALID_PARAMETER.

Wymagania

Platformy: Zobacz Wymagania systemowe.

Nagłówka: WMINet_Utils.idl

.NET Framework wersje: dostępne od wersji 4.7.2

Zobacz też

• Liczniki wydajności i usługi WMI (dokumentacja niezarządzanych interfejsów API)