IVssAdmin::RegisterProvider-Methode (vsadmin.h)

Artikel
08/27/2023

Die RegisterProvider-Methode registriert einen neuen Schattenkopieanbieter.

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
);

Parameter

[in] pProviderId

Die VSS_ID , die den Anbieter eindeutig und dauerhaft identifiziert. Nachdem er definiert wurde, sollte der ProviderId-Parameter gleich bleiben, auch wenn die Softwarerevision aktualisiert wird. Ein ProviderId-Parameter sollte nur geändert werden, wenn sich die Funktionalität so ändert, dass beide Anbieter auf demselben System aktiv sind. Ein Anforderer kann den ProviderId-Parameter verwenden, um anzufordern, dass ein bestimmter Anbieter bei der Erstellung einer Schattenkopie verwendet 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 unter Windows-Clientbetriebssystemversionen kein gültiger Anbietertyp 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 ProviderVersionId-Parameter eines anderen Anbieters identisch sein.

Rückgabewert

Diese Methode kann einen dieser Werte zurückgeben.

Rückgabecode	Beschreibung
S_OK	Der Anbieter wurde erfolgreich registriert.
E_INVALIDARG	Mindestens ein Parameterwert ist ungültig. Beispielsweise ist VSS_PROV_HARDWARE unter Windows-Clientbetriebssystemversionen kein gültiger Anbietertyp.
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 unter Windows Server 2008 R2 und Windows 7 unterstützt. stattdessen wird E_UNEXPECTED verwendet.

Hinweise

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

Hinweis Hardwareanbieter können nur unter Windows Server-Betriebssystemen registriert werden.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows Vista [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2003 [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	vsadmin.h

Weitere Informationen

IVssAdmin

UnregisterProvider

Freigeben über