ConnectServerWmi függvény

Kapcsolatot hoz létre a DCOM-on keresztül egy WMI-névtérrel egy adott számítógépen.

Megjegyzés

Ez az API csak belső használatra készült. Nem fejlesztői kódból való használatra készült.

Szintaxis

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

Paraméterek

strNetworkResource
[in] Mutató egy érvényesre BSTR , amely a megfelelő WMI-névtér objektumútvonalát tartalmazza. További információért tekintse meg a Megjegyzések szakaszt.

strUser
[in] Egy olyan érvényes BSTR mutató, amely tartalmazza a felhasználónevet. Az null érték az aktuális biztonsági környezetet jelzi. Ha a felhasználó az aktuálistól eltérő tartományból származik, strUser akkor a tartományt és a felhasználónevet is tartalmazhatja fordított perjellel elválasztva. strUser Egyszerű felhasználónév (UPN) formátumban is lehet, például userName@domainName: . További információért tekintse meg a Megjegyzések szakaszt.

strPassword
[in] A jelszót tartalmazó érvényes BSTR mutató. Az A null az aktuális biztonsági környezetet jelzi. Az üres sztring ("") egy érvényes, nulla hosszúságú jelszót jelöl.

strLocale
[in] Egy érvényes BSTR mutató, amely az információlekérés megfelelő területi beállítását jelzi. Microsoft területi beállításazonosítók esetén a sztring formátuma "MS_xxx", ahol xxx egy hexadecimális formátumú sztring, amely a területi azonosítót (LCID) jelzi. Ha érvénytelen területi beállítás van megadva, a metódus a Windows 7 kivételével ad vissza értéket WBEM_E_INVALID_PARAMETER , ahol a rendszer a kiszolgáló alapértelmezett területi beállítását használja. Ha "null1", a rendszer az aktuális területi beállítást használja.

lSecurityFlags
[in] A metódusnak átadandó ConnectServerWmi jelzők. Ennek a paraméternek a nulla (0) értéke azt eredményezi, hogy ConnectServerWmi a hívás csak a kiszolgálóval való kapcsolat létrejötte után tér vissza. Ez azt eredményezheti, hogy egy alkalmazás nem válaszol határozatlan ideig, ha a kiszolgáló meghibásodik. A többi érvényes érték a következő:

Állandó	Érték	Leírás
CONNECT_REPOSITORY_ONLY	0x40	Belső használatra fenntartva. Ne használja.
WBEM_FLAG_CONNECT_USE_MAX_WAIT	0x80	ConnectServerWmi két perc múlva vagy kevesebbet ad vissza.

strAuthority
[in] A felhasználó tartományneve. A következő értékeket veheti fel:

Érték	Leírás
Üres	A rendszer NTLM-hitelesítést használ, és az aktuális felhasználó NTLM-tartományát használja. Ha strUser megadja a tartományt (az ajánlott helyet), akkor itt nem szabad megadni. A függvény akkor ad WBEM_E_INVALID_PARAMETER vissza értéket, ha mindkét paraméterben megadja a tartományt.
Kerberos:egyszerű név	A rendszer Kerberos-hitelesítést használ, és ez a paraméter egy Kerberos-egyszerű nevet tartalmaz.
NTLMDOMAIN:tartománynév	A rendszer NT LAN Manager-hitelesítést használ, és ez a paraméter egy NTLM-tartománynevet tartalmaz.

pCtx
[in] Ez a paraméter általában a következő null: . Ellenkező esetben ez egy olyan IWbemContext objektumra mutat, amelyet egy vagy több dinamikus osztályszolgáltató igényel.

ppNamespace
[kifelé] Amikor a függvény visszatér, egy mutatót kap egy, a megadott névtérhez kötött IWbemServices objektumhoz. Úgy van beállítva, hogy hiba esetén mutasson null rá.

impLevel
[in] A megszemélyesítési szint.

authLevel
[in] Az engedélyezési szint.

Visszatérési érték

A függvény által visszaadott alábbi értékek a WbemCli.h fejlécfájlban vannak definiálva, vagy konstansként definiálhatók a kódban:

Állandó	Érték	Leírás
WBEM_E_FAILED	0x80041001	Általános hiba történt.
WBEM_E_INVALID_PARAMETER	0x80041008	Érvénytelen paraméter.
WBEM_E_OUT_OF_MEMORY	0x80041006	Nincs elegendő memória a művelet végrehajtásához.
WBEM_S_NO_ERROR	0	A függvényhívás sikeres volt.

Megjegyzések

Ez a függvény burkolja az IWbemLocator::ConnectServer metódus hívását .

Az alapértelmezett névtérhez strNetworkResource való helyi hozzáféréshez egy egyszerű objektumútvonal lehet: "root\default" vagy "\.\root\default". Ha com- vagy Microsoft-kompatibilis hálózatkezelést használó távoli számítógépen szeretné elérni az alapértelmezett névteret, adja meg a számítógép nevét: "\myserver\root\default". A számítógép neve lehet DNS-név vagy IP-cím is. A ConnectServerWmi függvény IPv6-os számítógépekkel is képes IPv6-címmel csatlakozni.

strUser Nem lehet üres sztring. Ha a tartományban van megadva strAuthority, akkor azt nem szabad belefoglalni a fájlba strUser, vagy a függvény a következőt adja WBEM_E_INVALID_PARAMETERvissza: .

Követelmények

Platformok: Lásd: Rendszerkövetelmények.

Fejléc: WMINet_Utils.idl

.NET-keretrendszer verziók: 4.7.2 óta érhető el

Lásd még

• WMI- és teljesítményszámlálók (nem felügyelt API-referencia)