IVssAdmin::RegisterProvider-Methode (vsadmin.h)

Die RegisterProvider-Methode registriert einen neuen Schattenkopie-Anbieter.

Syntax

HRESULT RegisterProvider(
  [in] VSS_ID            pProviderId,
  [in] CLSID             ClassId,
  [in] VSS_PWSZ          pwszProviderName,
  [in] VSS_PROVIDER_TYPE eProviderType,
  [in] VSS_PWSZ          pwszProviderVersion,
  [in] VSS_ID            ProviderVersionId
);

Die Parameter

[in] pProviderId

Die VSS_ID , die den Anbieter eindeutig und dauerhaft identifiziert. Nachdem er definiert wurde, sollte der Parameter "ProviderId " unverändert bleiben, auch wenn die Softwarerevision aktualisiert wird. Ein ProviderId-Parameter sollte nur geändert werden, wenn die Funktionalität so geändert wird, dass beide Anbieter im selben System aktiv wären. Ein Antragsteller kann den ProviderId-Parameter verwenden, um anzufordern, dass ein bestimmter Anbieter in einer Schattenkopie erstellt wird.

[in] ClassId

Die CLSID des Anbieters.

[in] pwszProviderName

Der Name des Anbieters.

[in] eProviderType

Ein VSS_PROVIDER_TYPE Enumerationswert, der den Anbietertyp angibt. Beachten Sie, dass VSS_PROV_HARDWARE kein gültiger Anbietertyp in Windows-Clientbetriebssystemversionen ist. Hardwareanbieter werden nur unter Windows Server-Betriebssystemversionen ausgeführt.

[in] pwszProviderVersion

Die Version des Anbieters.

[in] ProviderVersionId

Die VSS_ID , die diese Version des Anbieters eindeutig identifiziert. Die Kombination der Parameter "pProviderId " und " ProviderVersionId " sollte eindeutig sein. Der Parameter "ProviderVersionId " kann mit dem Parameter "ProviderVersionId " eines anderen Anbieters übereinstimmen.

Rückgabewert

Diese Methode kann einen dieser Werte zurückgeben.

Rückgabecode	Description
S_OK	Der Anbieter wurde erfolgreich registriert.
E_INVALIDARG	Mindestens ein Parameterwert ist ungültig. Beispielsweise ist VSS_PROV_HARDWARE kein gültiger Anbietertyp in Windows-Clientbetriebssystemversionen.
E_OUTOFMEMORY	Nicht genügend Arbeitsspeicher oder andere Systemressourcen.
E_ACCESSDENIED	Der Aufrufer ist kein Administrator.
VSS_E_PROVIDER_ALREADY_REGISTERED	Der Anbieter wurde bereits auf diesem Computer registriert.
VSS_E_UNEXPECTED	Unerwarteter Fehler. Der Fehlercode wird in der Fehlerprotokolldatei protokolliert. Weitere Informationen finden Sie unter " Ereignis- und Fehlerbehandlung unter VSS". Windows Server 2008, Windows Vista, Windows Server 2003 und Windows XP: Dieser Wert wird erst unterstützt, wenn Windows Server 2008 R2 und Windows 7. E_UNEXPECTED wird stattdessen verwendet.

Bemerkungen

Wenn der Hardwareanbieter aktualisiert wird, sollte die Setupanwendung die UnregisterProvider-Methode aufrufen, um die Registrierung der veralteten Version aufzuheben, und rufen Sie dann die RegisterProvider-Methode auf, um den aktualisierten Anbieter zu registrieren.

Anmerkung Hardwareanbieter können nur auf Windows Server-Betriebssystemen registriert werden.

 

Anforderungen

Anforderung	Wert
Mindestens unterstützter Client	Windows Vista [nur Desktop-Apps]
Mindestanforderungen für unterstützte Server	Windows Server 2003 [Nur Desktop-Apps]
Zielplattform	Fenster
Header	vsadmin.h

Siehe auch

IVssAdmin

UnregisterProvider