ConnectServerWmi – funkce

Vytvoří připojení prostřednictvím modelu DCOM k oboru názvů rozhraní WMI v zadaném počítači.

Poznámka

Toto rozhraní API je určené pouze pro interní použití. Není určen pro použití z kódu vývojáře.

Syntaxe

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
[v] Ukazatel na platný BSTR , který obsahuje cestu k objektu správného oboru názvů WMI. Další informace najdete v části Poznámky .

strUser
[v] Ukazatel na platný BSTR , který obsahuje uživatelské jméno. Hodnota null označuje aktuální kontext zabezpečení. Pokud je uživatel z jiné než aktuální domény, strUser může také obsahovat doménu a uživatelské jméno oddělené zpětným lomítkem. strUser může být také ve formátu hlavního názvu uživatele (UPN), například userName@domainName. Další informace najdete v části Poznámky .

strPassword
[v] Ukazatel na platný BSTR , který obsahuje heslo. A null označuje aktuální kontext zabezpečení. Prázdný řetězec ("") označuje platné heslo nulové délky.

strLocale
[v] Ukazatel na platný BSTR , který označuje správné národní prostředí pro načítání informací. U identifikátorů národního prostředí Společnosti Microsoft je formát řetězce "MS_xxx", kde xxx je řetězec v šestnáctkové podobě, který označuje identifikátor národního prostředí (LCID). Pokud je zadáno neplatné národní prostředí, metoda vrátí výjimku WBEM_E_INVALID_PARAMETER v systému Windows 7, kde je místo toho použito výchozí národní prostředí serveru. Pokud je null1, použije se aktuální národní prostředí.

lSecurityFlags
[v] Příznaky, které se mají předat metodě ConnectServerWmi . Hodnota nula (0) pro tento parametr způsobí, že se ConnectServerWmi volání vrátí až po navázání připojení k serveru. To může mít za následek, že aplikace nereaguje neomezeně dlouho, pokud je server poškozený. Další platné hodnoty jsou:

Konstanta	Hodnota	Popis
CONNECT_REPOSITORY_ONLY	0x40	Vyhrazeno pro interní použití. Nepoužívat.
WBEM_FLAG_CONNECT_USE_MAX_WAIT	0x80	ConnectServerWmi vrátí do dvou minut nebo méně.

strAuthority
[v] Název domény uživatele. Může mít následující hodnoty:

Hodnota	Popis
Prázdné	Použije se ověřování NTLM a použije se doména NTLM aktuálního uživatele. Pokud strUser určuje doménu (doporučené umístění), nesmí být zde zadána. Funkce vrátí, WBEM_E_INVALID_PARAMETER pokud v obou parametrech zadáte doménu.
Kerberos:hlavní název	Použije se ověřování protokolem Kerberos a tento parametr obsahuje hlavní název protokolu Kerberos.
NTLMDOMAIN:název domény	Používá se ověřování nt LAN Manager a tento parametr obsahuje název domény NTLM.

pCtx
[v] Tento parametr je nullobvykle . V opačném případě se jedná o ukazatel na objekt IWbemContext vyžadovaný jedním nebo více zprostředkovateli dynamických tříd.

ppNamespace
[out] Když funkce vrátí, přijme ukazatel na objekt IWbemServices vázaný na zadaný obor názvů. Pokud dojde k chybě, nastaví se tak, aby odkazovat na null .

impLevel
[v] Úroveň zosobnění.

authLevel
[v] Úroveň autorizace.

Vrácená hodnota

Následující hodnoty vrácené touto funkcí jsou definovány v hlavičce souboru WbemCli.h nebo je můžete definovat jako konstanty v kódu:

Konstanta	Hodnota	Popis
WBEM_E_FAILED	0x80041001	Došlo k obecné chybě.
WBEM_E_INVALID_PARAMETER	0x80041008	Parametr není platný.
WBEM_E_OUT_OF_MEMORY	0x80041006	K dokončení operace není k dispozici dostatek paměti.
WBEM_S_NO_ERROR	0	Volání funkce bylo úspěšné.

Poznámky

Tato funkce zabalí volání metody IWbemLocator::ConnectServer .

Pro místní přístup k výchozímu oboru názvů strNetworkResource může být jednoduchá cesta k objektu: "root\default" nebo "\.\root\default". Pokud chcete získat přístup k výchozímu oboru názvů na vzdáleném počítači pomocí modelu COM nebo sítě kompatibilní se společností Microsoft, zadejte název počítače: "\myserver\root\default". Název počítače může být také název DNS nebo IP adresa. Funkce se ConnectServerWmi také může připojit k počítačům s protokolem IPv6 pomocí adresy IPv6.

strUser nemůže být prázdný řetězec. Pokud je doména zadaná v strAuthority, nesmí být zahrnutá ani do strUser, nebo funkce vrátí WBEM_E_INVALID_PARAMETER.

Požadavky

Platformy: Viz Požadavky na systém.

Záhlaví: WMINet_Utils.idl

Verze rozhraní .NET Framework: K dispozici od verze 4.7.2

Viz také

• Rozhraní WMI a čítače výkonu (referenční dokumentace nespravovaného rozhraní API)