Udostępnij przez

CloneEnumWbemClassObject, funkcja

Tworzy kopię logiczną modułu wyliczającego, zachowując swoją bieżącą pozycję w wyliczeniu.

Uwaga

Ten interfejs API jest przeznaczony tylko do użytku wewnętrznego. Nie jest ona przeznaczona do użycia z kodu dewelopera.

Składnia

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] Odbiera wskaźnik do nowego obiektu IEnumWbemClassObject.

authLevel
[w] Poziom autoryzacji.

impLevel
[w] Poziom personifikacji.

pCurrentEnumWbemClassObject
[out] Wskaźnik do wystąpienia IEnumWbemClassObject do sklonowania.

strUser
[w] Nazwa użytkownika. Aby uzyskać więcej informacji, zobacz funkcję ConnectServerWmi .

strPassword
[w] Hasło. Aby uzyskać więcej informacji, zobacz funkcję ConnectServerWmi .

strAuthority
[w] Nazwa domeny użytkownika. Aby uzyskać więcej informacji, zobacz funkcję ConnectServerWmi .

Wartość zwracana

Następujące wartości zwracane przez tę funkcję są zdefiniowane w pliku nagłówka WbemCli.h lub można je zdefiniować jako stałe w kodzie:

Stała Wartość Opis
WBEM_E_FAILED 0x80041001 Wystąpiła ogólna awaria.
WBEM_E_INVALID_PARAMETER 0x80041008 Parametr jest nieprawidłowy.
WBEM_E_OUT_OF_MEMORY 0x80041006 Za mało pamięci jest dostępna do ukończenia operacji.
WBEM_E_TRANSPORT_FAILURE 0x80041015 Połączenie zdalnego wywołania procedury (RPC) między bieżącym procesem a usługą WMI nie powiodło się.
WBEM_S_NO_ERROR 0 Wywołanie funkcji zakończyło się pomyślnie.

Uwagi

Ta funkcja zawija wywołanie metody IEnumWbemClassObject::Clone .

Ta metoda sprawia, że kopia jest tylko "najlepszym wysiłkiem". Ze względu na dynamiczny charakter wielu obiektów CIM możliwe jest, że nowy moduł wyliczający nie wylicza tego samego zestawu obiektów, co źródłowy moduł wyliczający.

Jeśli wywołanie funkcji zakończy się niepowodzeniem, możesz uzyskać dodatkowe informacje o błędzie, wywołując funkcję GetErrorInfo .

Przykład

Aby zapoznać się z przykładem, zobacz metodę IEnumWbemClassObject::Clone .

Wymagania

Platformy: Zobacz Wymagania systemowe.

Nagłówka: WMINet_Utils.idl

.NET Framework wersje: dostępne od wersji 4.7.2

Zobacz też

  • Last updated on