CloneEnumWbemClassObject işlevi

Numaralandırmadaki geçerli konumunu koruyarak bir numaralandırıcının mantıksal kopyasını oluşturur.

Not

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

Sözdizimi

HRESULT CloneEnumWbemClassObject (
   [out] IEnumWbemClassObject**  ppEnum,
   [in] DWORD                    authLevel,
   [in] DWORD                    impLevel,
   [in] IEnumWbemClassObject*    pCurrentEnumWbemClassObject,
   [in] BSTR                     strUser,
   [in] BSTR                     strPassword,
   [in BSTR]                     strAuthority
);

Parametreler

ppEnum
[out] Yeni bir IEnumWbemClassObject işaretçisi alır.

authLevel
[in] Yetkilendirme düzeyi.

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

pCurrentEnumWbemClassObject
[out] Kopyalanacak IEnumWbemClassObject örneğine bir işaretçi.

strUser
[in] Kullanıcı adı. Daha fazla bilgi için bkz . ConnectServerWmi işlevi.

strPassword
[in] Parola. Daha fazla bilgi için bkz . ConnectServerWmi işlevi.

strAuthority
[in] Kullanıcının etki alanı adı. Daha fazla bilgi için bkz . ConnectServerWmi işlevi.

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çersiz.
WBEM_E_OUT_OF_MEMORY	0x80041006	İşlemi tamamlamak için yeterli bellek yok.
WBEM_E_TRANSPORT_FAILURE	0x80041015	Geçerli işlem ile WMI arasındaki uzak yordam çağrısı (RPC) bağlantısı başarısız oldu.
WBEM_S_NO_ERROR	0	İşlev çağrısı başarılı oldu.

Açıklamalar

Bu işlev , IEnumWbemClassObject::Clone yöntemine bir çağrı sarmalar.

Bu yöntem yalnızca "en iyi çaba" kopyasını oluşturur. Birçok CIM nesnesinin dinamik yapısı nedeniyle, yeni numaralandırıcının kaynak numaralandırıcıyla aynı nesne kümesini listelememesi mümkündür.

İşlev çağrısı başarısız olursa GetErrorInfo işlevini çağırarak ek hata bilgileri alabilirsiniz.

Örnek

Örnek için bkz . IEnumWbemClassObject::Clone yöntemi.

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)