Funktionen ConnectServerWmi

Skapar en anslutning via DCOM till ett WMI-namnområde på en angiven dator.

Anteckning

Det här API:et är endast för internt bruk. Det är inte avsett för användning från utvecklarkod.

Syntax

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

Parametrar

strNetworkResource
[i] Pekare till en giltig BSTR som innehåller objektsökvägen för rätt WMI-namnområde. Mer information finns i avsnittet Kommentarer .

strUser
[i] En pekare till en giltig BSTR som innehåller användarnamnet. Ett null värde anger den aktuella säkerhetskontexten. Om användaren kommer från en annan domän än den aktuella, strUser kan även innehålla domänen och användarnamnet avgränsade med ett omvänt snedstreck. strUser kan också vara i UPN-format (user principal name), till exempel userName@domainName. Mer information finns i avsnittet Kommentarer .

strPassword
[i] En pekare till en giltig BSTR som innehåller lösenordet. A null anger den aktuella säkerhetskontexten. En tom sträng ("") anger ett giltigt lösenord med noll längd.

strLocale
[i] En pekare till en giltig BSTR som anger rätt språk för informationshämtning. För Microsofts språkidentifierare är formatet för strängen "MS_xxx", där xxx är en sträng i hexadecimalt format som anger språkidentifieraren (LCID). Om ett ogiltigt språk anges returnerar WBEM_E_INVALID_PARAMETER metoden utom i Windows 7, där standardspråket för servern används i stället. Om 'null1, används det aktuella språket.

lSecurityFlags
[i] Flaggor som ska skickas ConnectServerWmi till metoden. Ett värde på noll (0) för den här parametern resulterar i att anropet till ConnectServerWmi returneras först när en anslutning till servern har upprättats. Detta kan leda till att ett program inte svarar på obestämd tid om servern är bruten. De andra giltiga värdena är:

Konstant	Värde	Beskrivning
CONNECT_REPOSITORY_ONLY	0x40	Reserverad för internt bruk. Använd inte.
WBEM_FLAG_CONNECT_USE_MAX_WAIT	0x80	ConnectServerWmi returnerar om två minuter eller mindre.

strAuthority
[i] Användarens domännamn. Den kan ha följande värden:

Värde	Beskrivning
tomt	NTLM-autentisering används och den aktuella användarens NTLM-domän används. Om strUser anger domänen (den rekommenderade platsen) får den inte anges här. Funktionen returnerar WBEM_E_INVALID_PARAMETER om du anger domänen i båda parametrarna.
Kerberos:principal name	Kerberos-autentisering används och den här parametern innehåller ett Kerberos-huvudnamn.
NTLMDOMAIN:domännamn	NT LAN Manager-autentisering används och den här parametern innehåller ett NTLM-domännamn.

pCtx
[i] Den här parametern är nullvanligtvis . Annars är det en pekare till ett IWbemContext-objekt som krävs av en eller flera dynamiska klassprovidrar.

ppNamespace
[ut] När funktionen returnerar får du en pekare till ett IWbemServices-objekt som är bundet till det angivna namnområdet. Den är inställd på att null peka på när det finns ett fel.

impLevel
[i] Personifieringsnivån.

authLevel
[i] Auktoriseringsnivån.

Returvärde

Följande värden som returneras av den här funktionen definieras i wbemCli.h-huvudfilen , eller så kan du definiera dem som konstanter i koden:

Konstant	Värde	Beskrivning
WBEM_E_FAILED	0x80041001	Det har uppstått ett allmänt fel.
WBEM_E_INVALID_PARAMETER	0x80041008	En parameter är inte giltig.
WBEM_E_OUT_OF_MEMORY	0x80041006	Det finns inte tillräckligt med minne för att slutföra åtgärden.
WBEM_S_NO_ERROR	0	Funktionsanropet lyckades.

Kommentarer

Den här funktionen omsluter ett anrop till IWbemLocator::ConnectServer-metoden .

För lokal åtkomst till standardnamnområdet strNetworkResource kan vara en enkel objektsökväg: "root\default" eller "\.\root\default". För åtkomst till standardnamnområdet på en fjärrdator som använder COM eller Microsoft-kompatibla nätverk, inkluderar du datornamnet: "\myserver\root\default". Datornamnet kan också vara ett DNS-namn eller en IP-adress. Funktionen ConnectServerWmi kan också ansluta till datorer som kör IPv6 med hjälp av en IPv6-adress.

strUser kan inte vara en tom sträng. Om domänen anges i strAuthorityfår den inte inkluderas i strUsereller så returnerar WBEM_E_INVALID_PARAMETERfunktionen .

Krav

Plattformar: Se Systemkrav.

Huvudet: WMINet_Utils.idl

.NET Framework versioner: Tillgänglig sedan 4.7.2

Se även

• WMI- och prestandaräknare (ohanterad API-referens)