IVssWMDependency::GetComponentName-Methode (vswriter.h)
Die GetComponentName-Methode ruft den Namen einer Komponente ab, von der die aktuelle Komponente in einer expliziten Writer-Komponentenabhängigkeit abhängt.
Syntax
HRESULT GetComponentName(
BSTR *pbstrComponentName
);
Parameter
pbstrComponentName
Die Adresse einer vom Aufrufer zugeordneten Variablen, die eine MIT NULL beendete Breitzeichenzeichenfolge empfängt, die den Namen der Komponente enthält, von der die aktuelle Komponente abhängt.
Rückgabewert
Diese Methode kann einen dieser Werte zurückgeben.
| Wert | Bedeutung |
|---|---|
|
Der Name der Komponente, von der die aktuelle Komponente abhängt, wurde erfolgreich zurückgegeben. |
|
Es kann kein Writer gefunden werden, der die Komponente verwaltet, von der die aktuelle Komponente abhängt. |
|
Der Zeiger pbstrComponentName verweist auf nicht zugeordneten Arbeitsspeicher. |
|
Der Aufrufer verfügt über nicht genügend Arbeitsspeicher oder andere Systemressourcen. |
|
Das XML-Dokument ist ungültig. Überprüfen Sie das Ereignisprotokoll auf Details. Weitere Informationen finden Sie unter Ereignis- und Fehlerbehandlung unter VSS. |
|
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
Der Aufrufer muss den von der zurückgegebenen Zeichenfolge verwendeten Arbeitsspeicher durch Aufrufen von SysFreeString freigeben.
Eine Abhängigkeit gibt keine Präferenzreihenfolge zwischen der Komponente mit den dokumentierten Abhängigkeiten und den Komponenten an, von denen sie abhängt. Eine Abhängigkeit gibt lediglich an, dass die Komponente und die Komponenten, von denen sie abhängt, immer zusammen gesichert oder wiederhergestellt werden müssen.
Es ist möglich, mehrere Instanzen einer bestimmten Writer-Klasse zu haben. Der logische Pfad und Name jeder Komponente sollte jedoch eindeutig sein.
Wenn mehrere Instanzen einer Writer-Klasse vorhanden sind, müssen Informationen zu logischem Pfad und Komponentennamen verwendet werden, um die instance die Komponente zu identifizieren, von der die aktuelle Komponente abhängt.
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 | vswriter.h (enthalten Vss.h, VsWriter.h) |
| Bibliothek | VssApi.lib |
Weitere Informationen
IVssWMComponent::GetDependency