ConfigureModule.ProvideTextData-Methode
Die ProvideTextData-Methode wird von „Mergemod.dll“ aufgerufen, um Textdaten aus dem Clienttool abzurufen. „Mergemod.dll“ gibt den Namen im entsprechenden Eintrag in der ModuleConfiguration-Tabelle an.
Das Tool sollte S_OK zurückgeben und den entsprechenden Anpassungstext in ConfigData bereitstellen. Das Clienttool ist für die Zuteilung der Daten, „Mergemod.dll“ jedoch für die Freigabe des Arbeitsspeichers zuständig. Dieses Argument MUSS ein BSTR-Objekt sein. LPCWSTR wird NICHT akzeptiert.
Wenn das Tool keine Konfigurationsdaten für diesen Name-Wert bereitstellt, muss die Funktion S_FALSE zurückgeben. In diesem Fall ignoriert „Mergemod.dll“ den Wert des ConfigData-Arguments und verwendet den Standardwert in der ModuleConfiguration-Tabelle.
Jeder andere Rückgabecode als S_OK oder S_FALSE führt dazu, dass ein Fehler protokolliert wird (sofern ein Protokoll geöffnet ist), und zu einem Zusammenführungsfehler.
Da diese Funktion der Standardkonvention für BSTR folgt, entspricht NULL der leeren Zeichenfolge.
Syntax
ConfigureModule.ProvideTextData(
Name,
ConfigData
)
Parameter
-
Name
-
Name des Elements, für das Daten abgerufen werden.
-
ConfigData
-
Zeiger auf Anpassungstext.
Rückgabewert
Diese Methode gibt keinen Wert zurück.
Bemerkungen
Der Client darf nicht mehr als einmal für jeden Datensatz in der ModuleConfiguration-Tabelle aufgerufen werden. Beachten Sie, dass „Mergemod.dll“ nicht mehrere Aufrufe an den Client für denselben Wert für „Name“ richtet. Wenn kein Datensatz in der ModuleSubstitution-Tabelle die Eigenschaft verwendet, verursacht ein Eintrag in der ModuleConfiguration-Tabelle keine Aufrufe des Clients.
C++
Siehe ProvideTextData-Funktion.
Anforderungen
| Anforderung | Wert |
|---|---|
| Version |
Mergemod.dll 2.0 oder höher |
| Header |
|
| DLL |
|