Méthode IVssExamineWriterMetadataEx ::GetIdentityEx (vsbackup.h)
La méthode GetIdentityEx obtient le nom instance writer et d’autres informations de base sur un instance de writer spécifique.
Syntaxe
HRESULT GetIdentityEx(
[out] VSS_ID *pidInstance,
[out] VSS_ID *pidWriter,
[out] BSTR *pbstrWriterName,
[out] BSTR *pbstrInstanceName,
[out] VSS_USAGE_TYPE *pUsage,
[out] VSS_SOURCE_TYPE *pSource
);
Paramètres
[out] pidInstance
Identificateur global unique (GUID) du writer instance.
[out] pidWriter
GUID de la classe writer.
[out] pbstrWriterName
Pointeur vers une chaîne spécifiant le nom de l’enregistreur.
[out] pbstrInstanceName
Pointeur vers une chaîne spécifiant le nom instance writer.
[out] pUsage
Pointeur vers une valeur d’énumération VSS_USAGE_TYPE indiquant comment les données gérées par l’enregistreur sont utilisées sur le système hôte.
[out] pSource
Pointeur vers une valeur d’énumération VSS_SOURCE_TYPE indiquant le type de données gérées par l’enregistreur.
Valeur retournée
Voici les codes de retour valides pour cette méthode.
| Valeur | Signification |
|---|---|
|
Les informations d’identité ont été retournées. |
|
L’une des valeurs de paramètre n’est pas valide. |
|
L’appelant n’a plus de mémoire ou d’autres ressources système. |
|
Le document XML n’est pas valide. Pour plus d’informations, consultez le journal des événements. Pour plus d’informations, consultez Gestion des événements et des erreurs sous VSS. |
|
Erreur inattendue. Le code d’erreur est enregistré dans le fichier journal des erreurs. Pour plus d’informations, consultez Gestion des événements et des erreurs sous VSS.
Windows Server 2008, Windows Vista, Windows Server 2003 et Windows XP : Cette valeur n’est pas prise en charge tant que Windows Server 2008 R2 et Windows 7. E_UNEXPECTED est utilisé à la place. |
Remarques
Cette méthode est identique à la méthode IVssExamineWriterMetadata ::GetIdentity , à l’exception du paramètre pbstrInstanceName .
Le paramètre pbstrInstanceName est le nom instance writer qui a été spécifié lors de l’initialisation de l’enregistreur par CVssWriter ::Initialize.
Le nom instance writer est utile pour les rédacteurs qui prennent en charge l’exécution de plusieurs instances de writer avec le même ID de classe writer sur un seul ordinateur. Le nom instance de l’enregistreur peut être utilisé pour identifier le instance spécifique. Par conséquent, l’enregistreur doit rendre le nom instance unique au sein de la classe writer. En outre, le nom du instance de l’enregistreur est censé persister entre la sauvegarde et la restauration, et il est utilisé par VSS pour restaurer correctement les enregistreurs à plusieurs instance.
L’appelant doit libérer la mémoire détenue par les paramètres pbstrWriterName et pbstrInstanceName en appelant SysFreeString.
Une interface IVssExamineWriterMetadataEx peut provenir des informations d’état de l’enregistreur stockées (créées par un appel à CreateVssExamineWriterMetadata). Si tel est le cas, les éléments suivants sont vrais :
- pidInstance ne signifie peut-être rien en termes d’écrivains en direct.
- Si pidWriter ne correspond pas à la classe writer d’un writer en direct, un demandeur ne doit pas utiliser les composants de cet enregistreur.
Configuration requise
| Condition requise | Valeur |
|---|---|
| Client minimal pris en charge | Windows Vista [applications de bureau uniquement] |
| Serveur minimal pris en charge | Windows Server 2008, Windows Server 2003 avec SP1 [applications de bureau uniquement] |
| Plateforme cible | Windows |
| En-tête | vsbackup.h (inclure VsBackup.h, Vss.h, VsWriter.h) |
| Bibliothèque | VssApi.lib |