CloneEnumWbemClassObject-Funktion

  • Artikel

Erstellt eine logische Kopie eines Enumerators unter Beibehaltung der aktuellen Position in einer Enumeration.

Hinweis

Diese API ist ausschließlich für die interne Verwendung vorgesehen. Sie ist nicht für die Verwendung im Entwicklercode vorgesehen.

Syntax

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

Parameter

ppEnum
[out] Empfängt einen Zeiger auf ein neues IEnumWbemClassObject.

authLevel
[in] Die Autorisierungsstufe.

impLevel
[in] Die Identitätswechselebene.

pCurrentEnumWbemClassObject
[out] Ein Zeiger auf die zu klonende IEnumWbemClassObject-Instanz.

strUser
[in] Der Benutzername. Weitere Informationen finden Sie in der ConnectServerWmi-Funktion.

strPassword
[in] Das Kennwort. Weitere Informationen finden Sie in der ConnectServerWmi-Funktion.

strAuthority
[in] Der Domänenname des Benutzers. Weitere Informationen finden Sie in der ConnectServerWmi-Funktion.

Rückgabewert

Die folgenden von dieser Funktion zurückgegebenen Werte werden in der WbemCli.h-Headerdatei definiert, oder Sie können sie als Konstanten im Code definieren:

Konstante Wert BESCHREIBUNG
WBEM_E_FAILED 0x80041001 Es ist ein allgemeiner Fehler aufgetreten.
WBEM_E_INVALID_PARAMETER 0x80041008 Ein Parameter ist ungültig.
WBEM_E_OUT_OF_MEMORY 0x80041006 Es ist nicht genügend Arbeitsspeicher verfügbar, um den Vorgang abzuschließen.
WBEM_E_TRANSPORT_FAILURE 0x80041015 Fehler bei der Remoteprozeduraufruf-Verbindung (RPC) zwischen dem aktuellen Prozess und WMI.
WBEM_S_NO_ERROR 0 Der Funktionsaufruf war erfolgreich.

Bemerkungen

Diese Funktion umschließt einen Aufruf der IEnumWbemClassObject::Clone-Methode.

Diese Methode erstellt nur eine „Best Effort“-Kopie. Aufgrund der dynamischen Natur vieler CIM-Objekte ist es möglich, dass der neue Enumerator nicht denselben Satz von Objekten aufzählt wie der Quellenumerator.

Wenn der Funktionsaufruf fehlschlägt, können Sie zusätzliche Fehlerinformationen abrufen, indem Sie die GetErrorInfo-Funktion aufrufen.

Beispiel

Ein Beispiel finden Sie unter der IEnumWbemClassObject::Clone-Methode.

Anforderungen

Plattformen: Informationen finden Sie unter Systemanforderungen.

Header: WMINet_Utils.idl

.NET Framework-Versionen: Seit Version 4.7.2 verfügbar

Weitere Informationen