Hinweis
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, sich anzumelden oder das Verzeichnis zu wechseln.
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, das Verzeichnis zu wechseln.
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 |
|---|---|
|
Der Anbieter wurde erfolgreich registriert. |
|
Mindestens ein Parameterwert ist ungültig. Beispielsweise ist VSS_PROV_HARDWARE kein gültiger Anbietertyp in Windows-Clientbetriebssystemversionen. |
|
Nicht genügend Arbeitsspeicher oder andere Systemressourcen. |
|
Der Aufrufer ist kein Administrator. |
|
Der Anbieter wurde bereits auf diesem Computer registriert. |
|
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 |