Metodo CVssWriter::Initialize (vswriter.h)
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 |
|---|---|
|
Inizializzazione dell'oggetto writer completata. |
|
Impossibile inizializzare l'oggetto writer. l'infrastruttura del writer VSS era inattiva perché Windows era in modalità provvisoria o era configurato. |
|
Il chiamante non è un amministratore. |
|
Uno dei valori dei parametri non è valido. |
|
Il chiamante non è in memoria o in altre risorse di sistema. |
|
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 |