Metodo CVssWriter::Initialize (vswriter.h)

Articolo
03/08/2023

Inizializza un oggetto CVssWriter e consente a un'applicazione writer di interagire con VSS.

Initialize è un metodo pubblico implementato dalla classe di base CVssWriter .

Sintassi

HRESULT Initialize(
  [in] VSS_ID                     WriterId,
  [in] LPCWSTR                    wszWriterName,
  [in] VSS_USAGE_TYPE             ut,
  [in] VSS_SOURCE_TYPE            st,
  [in] VSS_APPLICATION_LEVEL      nLevel,
  [in] DWORD                      dwTimeoutFreeze,
  [in] VSS_ALTERNATE_WRITER_STATE aws,
  [in] bool                       bIOThrottlingOnly,
  [in] LPCWSTR                    wszWriterInstanceName
);

Parametri

[in] WriterId

Identificatore univoco globale (GUID) della classe writer.

[in] wszWriterName

Stringa di caratteri wide con terminazione Null contenente il nome del writer. Questa stringa non è localizzata.

[in] ut

Valore di enumerazione VSS_USAGE_TYPE che indica come vengono usati i dati gestiti dal writer nel sistema host.

[in] st

Valore di enumerazione VSS_SOURCE_TYPE che indica il tipo di dati gestiti dal writer.

[in] nLevel

Valore di enumerazione VSS_APPLICATION_LEVEL che indica il livello dell'applicazione a cui il writer riceve una notifica di evento Freeze .

Il valore predefinito per questo parametro è VSS_APP_FRONT_END.

[in] dwTimeoutFreeze

Tempo massimo consentito, in millisecondi, tra la ricezione di una notifica di evento freeze di un writer e la ricezione di una notifica di evento Thaw corrispondente da VSS. Dopo la scadenza del timeout, il metodo CVssWriter::OnAbort del writer viene chiamato automaticamente.

Il valore predefinito per questo parametro è 60000.

[in] aws

Valore di enumerazione VSS_ALTERNATE_WRITER_STATE che indica se il writer ha un writer alternativo associato.

Il valore predefinito per questo parametro è VSS_AWS_NO_ALTERNATE_WRITER. Il chiamante non deve eseguire l'override di questo valore predefinito. Questo parametro è riservato per usi futuri.

[in] bIOThrottlingOnly

Impostare questo parametro su true se i metodi di limitazione delle operazioni di I/O sono abilitati o false in caso contrario.

Il valore predefinito per questo parametro è false. Il chiamante non deve eseguire l'override di questo valore predefinito. Questo parametro è riservato per usi futuri.

[in] wszWriterInstanceName

Stringa di caratteri wide con terminazione Null contenente il nome dell'istanza del writer.

Il valore predefinito per questo parametro è NULL. Se il writer ha più istanze e richiede eventi di ripristino, questo parametro è obbligatorio e non può essere NULL. Per informazioni dettagliate, vedere la sezione Osservazioni seguente.

Windows Server 2003 e Windows XP: Prima di Windows Server 2003 con SP1, questo parametro è riservato per l'uso del sistema e il chiamante non deve eseguire l'override del valore predefinito.

Valore restituito

Di seguito sono riportati i codici restituiti validi per questo metodo.

Valore	Significato
S_OK	Inizializzazione dell'oggetto writer completata.
S_FALSE	Impossibile inizializzare l'oggetto writer. l'infrastruttura del writer VSS era inattiva perché Windows era in modalità provvisoria o era configurato.
E_ACCESSDENIED	Il chiamante non è un amministratore.
E_INVALIDARG	Uno dei valori dei parametri non è valido.
E_OUTOFMEMORY	Il chiamante non è in memoria o in altre risorse di sistema.
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.

Commenti

Vss assegna un ID istanza di writer univoco a ogni istanza di un'applicazione writer. Se nel sistema sono presenti più istanze contemporaneamente (ad esempio, se più server SQL sono in esecuzione in un sistema), ogni writer viene identificato in modo univoco dalla combinazione dell'ID classe writer e del relativo ID istanza del writer.

Il parametro wszWriterInstanceName consente a un writer a istanze multipla di specificare un nome permanente per ogni istanza del writer come stringa leggibile. Questo nome deve essere univoco in tutte le istanze del writer nel sistema. Se un writer ha più istanze e richiede eventi di ripristino, deve specificare una stringa non NULL per questo parametro. VsS usa il nome dell'istanza per ripristinare correttamente i writer a istanze multiple.

Requisiti


Client minimo supportato	Windows XP [solo app desktop]
Server minimo supportato	Windows Server 2003 [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	vswriter.h (include Vss.h, VsWriter.h)
Libreria	VssApi.lib