De functie ConnectServerWmi

Hiermee maakt u een verbinding via DCOM met een WMI-naamruimte op een opgegeven computer.

Notitie

Deze API is alleen voor intern gebruik. Het is niet bedoeld voor gebruik vanuit code voor ontwikkelaars.

Syntaxis

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

Parameters

strNetworkResource
[in] Aanwijzer naar een geldige BSTR die het objectpad van de juiste WMI-naamruimte bevat. Zie de sectie Opmerkingen voor meer informatie.

strUser
[in] Een aanwijzer naar een geldige BSTR die de gebruikersnaam bevat. Een null waarde geeft de huidige beveiligingscontext aan. Als de gebruiker afkomstig is van een ander domein dan het huidige domein, strUser kan ook het domein en de gebruikersnaam bevatten, gescheiden door een backslash. strUser kan ook de UPN-indeling (User Principal Name) hebben, zoals userName@domainName. Zie de sectie Opmerkingen voor meer informatie.

strPassword
[in] Een verwijzing naar een geldige BSTR die het wachtwoord bevat. A null geeft de huidige beveiligingscontext aan. Een lege tekenreeks ("") geeft een geldig wachtwoord met lengte nul aan.

strLocale
[in] Een verwijzing naar een geldige BSTR die de juiste landinstelling aangeeft voor het ophalen van informatie. Voor landinstellingen-id's van Microsoft is de notatie van de tekenreeks 'MS_xxx', waarbij xxx een tekenreeks in hexadecimale vorm is die de landinstellings-id (LCID) aangeeft. Als er een ongeldige landinstelling is opgegeven, retourneert WBEM_E_INVALID_PARAMETER de methode, behalve in Windows 7, waar in plaats daarvan de standaardinstelling van de server wordt gebruikt. Als 'null1' is, wordt de huidige landinstelling gebruikt.

lSecurityFlags
[in] Markeringen die moeten worden doorgegeven aan de ConnectServerWmi methode. Een waarde van nul (0) voor deze parameter resulteert in de aanroep om alleen te ConnectServerWmi retourneren nadat een verbinding met de server tot stand is gebracht. Dit kan ertoe leiden dat een toepassing niet voor onbepaalde tijd reageert als de server is onderbroken. De andere geldige waarden zijn:

Constant	Waarde	Beschrijving
CONNECT_REPOSITORY_ONLY	0x40	Gereserveerd voor intern gebruik. Niet gebruiken.
WBEM_FLAG_CONNECT_USE_MAX_WAIT	0x80	ConnectServerWmi retourneert over twee minuten of minder.

strAuthority
[in] De domeinnaam van de gebruiker. Het kan de volgende waarden hebben:

Waarde	Beschrijving
Lege	NTLM-verificatie wordt gebruikt en het NTLM-domein van de huidige gebruiker wordt gebruikt. Als strUser het domein (de aanbevolen locatie) opgeeft, mag dit hier niet worden opgegeven. De functie retourneert WBEM_E_INVALID_PARAMETER als u het domein in beide parameters opgeeft.
Kerberos:principal name	Kerberos-verificatie wordt gebruikt en deze parameter bevat een Kerberos principal-naam.
NTLMDOMAIN:domeinnaam	NT LAN Manager-verificatie wordt gebruikt en deze parameter bevat een NTLM-domeinnaam.

pCtx
[in] Deze parameter is nulldoorgaans . Anders is het een verwijzing naar een IWbemContext-object dat is vereist door een of meer dynamische klasseproviders.

ppNamespace
[uit] Wanneer de functie retourneert, ontvangt een aanwijzer naar een IWbemServices-object dat is gebonden aan de opgegeven naamruimte. Deze wordt ingesteld om te verwijzen naar null wanneer er een fout optreedt.

impLevel
[in] Het imitatieniveau.

authLevel
[in] Het autorisatieniveau.

Retourwaarde

De volgende waarden die door deze functie worden geretourneerd, worden gedefinieerd in het headerbestand WbemCli.h , of u kunt ze definiëren als constanten in uw code:

Constant	Waarde	Beschrijving
WBEM_E_FAILED	0x80041001	Er is een algemene fout opgetreden.
WBEM_E_INVALID_PARAMETER	0x80041008	Een parameter is ongeldig.
WBEM_E_OUT_OF_MEMORY	0x80041006	Er is onvoldoende geheugen beschikbaar om de bewerking te voltooien.
WBEM_S_NO_ERROR	0	De functie-aanroep is geslaagd.

Opmerkingen

Deze functie verpakt een aanroep naar de methode IWbemLocator::ConnectServer .

Voor lokale toegang tot de standaardnaamruimte strNetworkResource kan een eenvoudig objectpad zijn: 'root\default' of '\.\root\default'. Voor toegang tot de standaardnaamruimte op een externe computer met com- of Microsoft-compatibele netwerken, neemt u de computernaam op: \myserver\root\default. De computernaam kan ook een DNS-naam of IP-adres zijn. De ConnectServerWmi functie kan ook verbinding maken met computers met IPv6 met behulp van een IPv6-adres.

strUser mag geen lege tekenreeks zijn. Als het domein is opgegeven in strAuthority, mag het niet ook worden opgenomen in strUser, of de functie retourneert WBEM_E_INVALID_PARAMETER.

Vereisten

Platforms: Zie Systeemvereisten.

Header: WMINet_Utils.idl

.NET Framework versies: beschikbaar sinds 4.7.2

Zie ook

• WMI en prestatiemeteritems (niet-beheerde API-verwijzing)