Funkce CloneEnumWbemClassObject

Vytvoří logickou kopii výčtu a zachová jeho aktuální pozici ve výčtu.

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 CloneEnumWbemClassObject (
   [out] IEnumWbemClassObject**  ppEnum,
   [in] DWORD                    authLevel,
   [in] DWORD                    impLevel,
   [in] IEnumWbemClassObject*    pCurrentEnumWbemClassObject,
   [in] BSTR                     strUser,
   [in] BSTR                     strPassword,
   [in BSTR]                     strAuthority
);

Parametry

ppEnum
[out] Obdrží ukazatel na nový IEnumWbemClassObject.

authLevel
[v] Úroveň autorizace.

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

pCurrentEnumWbemClassObject
[out] Ukazatel na instanci IEnumWbemClassObject , která má být klonována.

strUser
[v] Uživatelské jméno. Další informace najdete ve funkci ConnectServerWmi .

strPassword
[v] Heslo. Další informace najdete ve funkci ConnectServerWmi .

strAuthority
[v] Název domény uživatele. Další informace najdete ve funkci ConnectServerWmi .

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 je neplatný.
WBEM_E_OUT_OF_MEMORY	0x80041006	Operaci dokončete tím, že není k dispozici dostatek paměti.
WBEM_E_TRANSPORT_FAILURE	0x80041015	Propojení vzdáleného volání procedur (RPC) mezi aktuálním procesem a rozhraním WMI selhalo.
WBEM_S_NO_ERROR	0	Volání funkce bylo úspěšné.

Poznámky

Tato funkce zabalí volání metody IEnumWbemClassObject::Clone .

Tato metoda provádí pouze kopírování v "nejlepším úsilí". Vzhledem k dynamické povaze mnoha objektů CIM je možné, že nový enumerátor nevypíše stejnou sadu objektů jako zdrojový enumerátor.

Pokud volání funkce selže, můžete získat další informace o chybě voláním funkce GetErrorInfo .

Příklad

Příklad naleznete IEnumWbemClassObject::Clone metoda.

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)