ConnectServerWmi işlevi

DCOM aracılığıyla belirtilen bilgisayardaki WMI ad alanına bağlantı oluşturur.

Not

Bu API yalnızca iç kullanıma yöneliktir. Geliştirici kodundan kullanılmak üzere tasarlanmamıştır.

Sözdizimi

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

Parametreler

strNetworkResource
[in] Doğru WMI ad alanının nesne yolunu içeren geçerli BSTR bir işaretçi. Daha fazla bilgi için Açıklamalar bölümüne bakın.

strUser
[in] Kullanıcı adını içeren geçerli BSTR bir işaretçi. Bir null değer geçerli güvenlik bağlamını gösterir. Kullanıcı geçerli etki alanından farklı bir etki alanındansa, strUser etki alanını ve kullanıcı adını ters eğik çizgiyle ayırarak da içerebilir. strUser gibi kullanıcı asıl adı (UPN) biçiminde userName@domainNamede olabilir. Daha fazla bilgi için Açıklamalar bölümüne bakın.

strPassword
[in] Parolayı içeren geçerli BSTR bir işaretçi. A null , geçerli güvenlik bağlamını gösterir. Boş dize ("") geçerli bir sıfır uzunluklu parolayı gösterir.

strLocale
[in] Bilgi almak için doğru yerel ayarı gösteren geçerli BSTR bir işaretçi. Microsoft yerel ayar tanımlayıcıları için dizenin biçimi "MS_xxx"tir; burada xxx , yerel ayar tanımlayıcısını (LCID) gösteren onaltılık biçimde bir dizedir. Geçersiz bir yerel ayar belirtilirse, bunun yerine sunucunun varsayılan yerel ayarının kullanıldığı Windows 7 dışında bir yöntem döndürür WBEM_E_INVALID_PARAMETER . 'null1' ise geçerli yerel ayar kullanılır.

lSecurityFlags
[in] Yöntemine geçirmek için bayraklar ConnectServerWmi . Bu parametre için sıfır (0) değeri, çağrının ConnectServerWmi ancak sunucu bağlantısı kurulduktan sonra döndürülmesine neden olur. Bu, sunucu bozuksa uygulamanın süresiz olarak yanıt vermemesiyle sonuçlanabilir. Diğer geçerli değerler şunlardır:

Sabit	Değer	Açıklama
CONNECT_REPOSITORY_ONLY	0x40	dahili kullanım için ayrılmıştır. Kullanmayın.
WBEM_FLAG_CONNECT_USE_MAX_WAIT	0x80	ConnectServerWmi iki dakika veya daha kısa bir zaman içinde döndürür.

strAuthority
[in] Kullanıcının etki alanı adı. Aşağıdaki değerlere sahip olabilir:

Değer	Açıklama
Boş	NTLM kimlik doğrulaması kullanılır ve geçerli kullanıcının NTLM etki alanı kullanılır. Etki alanını (önerilen konum) belirtirse strUser , burada belirtilmemelidir. etki alanını her iki parametrede de belirtirseniz işlevi döndürür WBEM_E_INVALID_PARAMETER .
Kerberos:asıl ad	Kerberos kimlik doğrulaması kullanılır ve bu parametre bir Kerberos asıl adı içerir.
NTLMDOMAIN:etki alanı adı	NT LAN Manager kimlik doğrulaması kullanılır ve bu parametre bir NTLM etki alanı adı içerir.

pCtx
[in] Genellikle, bu parametre şeklindedir null. Aksi takdirde, bir veya daha fazla dinamik sınıf sağlayıcısının gerektirdiği bir IWbemContext nesnesinin işaretçisidir.

ppNamespace
[out] İşlev döndürdüğünde, belirtilen ad alanına bağlı bir IWbemServices nesnesinin işaretçisini alır. Hata olduğunda işaret etmek için null ayarlanır.

impLevel
[in] Kimliğe bürünme düzeyi.

authLevel
[in] Yetkilendirme düzeyi.

Döndürülen değer

Bu işlev tarafından döndürülen aşağıdaki değerler WbemCli.h üst bilgi dosyasında tanımlanır veya bunları kodunuzda sabit olarak tanımlayabilirsiniz:

Sabit	Değer	Açıklama
WBEM_E_FAILED	0x80041001	Genel bir hata oluştu.
WBEM_E_INVALID_PARAMETER	0x80041008	Parametre geçerli değil.
WBEM_E_OUT_OF_MEMORY	0x80041006	İşlemi tamamlamak için yeterli bellek yok.
WBEM_S_NO_ERROR	0	İşlev çağrısı başarılı oldu.

Açıklamalar

Bu işlev IWbemLocator::ConnectServer yöntemine bir çağrı sarmalar.

Varsayılan ad alanına yerel erişim için basit strNetworkResource bir nesne yolu olabilir: "root\default" veya "\.\root\default". COM veya Microsoft uyumlu ağ kullanarak uzak bilgisayardaki varsayılan ad alanına erişim için bilgisayar adını ekleyin: "\myserver\root\default". Bilgisayar adı bir DNS adı veya IP adresi de olabilir. İşlev, ConnectServerWmi IPv6 adresi kullanarak IPv6 çalıştıran bilgisayarlara da bağlanabilir.

strUser boş bir dize olamaz. etki alanı içinde strAuthoritybelirtilmişse, içinde de dahil strUseredilmemelidir veya işlevi döndürür WBEM_E_INVALID_PARAMETER.

Gereksinimler

Platform: Bkz. Sistem Gereksinimleri.

Üstbilgi: WMINet_Utils.idl

.NET Framework Sürümleri: 4.7.2 sürümünden itibaren kullanılabilir

Ayrıca bkz.

• WMI ve Performans Sayaçları (Yönetilmeyen API Başvurusu)