SourceName
Die Eigenschaft SourceName gibt den formatierten Sourcenamen für die angefragte Sprache zurück. Intern ruft sie die Methode TcLogFormatter::GetCompleteString des Formatters auf, der zugeordnet wurde, als das Event von einem COM Client ausgegeben wurde, oder durch einen ADS Aufruf an das Objekt TcEventLog des TcEventLoggers.
HRESULT SourceName([in] long langId, [out,retval] BSTR* szName);
Parameter
langId
[in] Die Sprach Id der angefragten Sprache. Die angeforderte Sprache sollte durch *LCIDs markiert werden. Die nächste Tabelle zeigt Beispiele für einige Sprach Ids. In der Konfiguration des Event Formatters sind die Sprachen mit der gleichen Sprach Id gekennzeichnet.
LCID | Beschreibung |
|---|---|
1031 | Deutsch |
1033 | US Englisch |
1034 | Spanisch |
1036 | Französisch |
szName
[out, retval] Pointer auf ein BSTR String, der den formatierten String für das Event SourceName zurückgibt.
Rückgabe Werte
S_OK
Funktion wurde erfolgreich aufgerufen.
E_POINTER
szName war kein gültiger Pointer.
Visual Basic Beispielcode
' get the one and only event logger
Dim evtLogger As TCEVENTLOGGERLib.TcEventLog
Set evtLogger = New TCEVENTLOGGERLib.TcEventLog
' get the most resent active event
Dim evt As TcEvent
Set evt = evtLogger.GetLastEvent
' get the source name in English
Dim name As String
name = evt.SourceName(1033)
Debug.Print name
Anmerkungen
Die meisten standardisierten Formatter, wie der XML basierende Formatter (TcEventFormatter.TcXmlFormatter), werden versuchen, den String für die Standard-Sprache zurückzugeben, falls die angefragte Sprache nicht in der Konfiguration des Formatters existiert.
*LCID: weitere Informationen finden Sie in der MSDN Library.