Metodo IVssAdmin::RegisterProvider (vsadmin.h)

Il metodo RegisterProvider registra un nuovo provider di copia shadow.

Sintassi

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

Parametri

[in] pProviderId

Il VSS_ID che identifica in modo univoco e permanente il provider. Dopo la definizione, il parametro ProviderId deve rimanere invariato, anche quando viene aggiornata la revisione software. Un parametro ProviderId deve essere modificato solo quando la funzionalità cambia abbastanza che entrambi i provider sarebbero attivi nello stesso sistema. Un richiedente può usare il parametro ProviderId per richiedere l'uso di un provider specifico in una creazione della copia shadow.

[in] ClassId

CLSID del provider.

[in] pwszProviderName

Nome del provider.

[in] eProviderType

Valore di enumerazione VSS_PROVIDER_TYPE che specifica il tipo di provider. Si noti che VSS_PROV_HARDWARE non è un tipo di provider valido nelle versioni del sistema operativo client Windows. I provider hardware verranno eseguiti solo nelle versioni del sistema operativo Windows Server.

[in] pwszProviderVersion

Versione del provider.

[in] ProviderVersionId

Il VSS_ID che identifica in modo univoco questa versione del provider. La combinazione dei parametri pProviderId e ProviderVersionId deve essere univoca. Il parametro ProviderVersionId può essere uguale al parametro ProviderVersionId di un altro provider.

Valore restituito

Questo metodo può restituire uno di questi valori.

Codice restituito	Description
S_OK	Il provider è stato registrato correttamente.
E_INVALIDARG	Uno o più valori dei parametri non sono validi. Ad esempio, VSS_PROV_HARDWARE non è un tipo di provider valido nelle versioni del sistema operativo client Windows.
E_OUTOFMEMORY	Memoria insufficiente o altre risorse di sistema.
E_ACCESSDENIED	Il chiamante non è un amministratore.
VSS_E_PROVIDER_ALREADY_REGISTERED	Il provider è già stato registrato nel computer.
VSS_E_UNEXPECTED	Errore imprevisto. Il codice di errore viene registrato nel file di log degli errori. Per altre informazioni, vedere Gestione degli eventi e degli errori in VSS. Windows Server 2008, Windows Vista, Windows Server 2003 e Windows XP: Questo valore non è supportato fino a Windows Server 2008 R2 e Windows 7. E_UNEXPECTED viene invece usato.

Osservazioni:

Se il provider hardware viene aggiornato, l'applicazione di installazione deve chiamare il metodo UnregisterProvider per annullare la registrazione della versione obsoleta e quindi chiamare il metodo RegisterProvider per registrare il provider aggiornato.

Nota I provider hardware possono essere registrati solo nei sistemi operativi Windows Server.

 

Requisiti

Requisito	Value
Client minimo supportato	Windows Vista [solo app desktop]
Server minimo supportato	Windows Server 2003 [solo app desktop]
Piattaforma di destinazione	Windows
Header	vsadmin.h

Vedere anche

IVssAdmin

UnregisterProvider