IMsmConfigureModule::P rovideTextData-Methode (mergemod.h)
Die ProvideTextData-Methode ruft Textdaten aus dem Clienttool ab. Weitere Informationen finden Sie in der ProvideTextData-Methode des ConfigureModule-Objekts .
Syntax
HRESULT ProvideTextData(
[in] const BSTR Name,
[out] BSTR *ConfigData
);
Parameter
[in] Name
Wenn das Tool keine Konfigurationsdaten für diesen Wert bereitstellt, sollte die Funktion S_FALSE zurückgeben. In diesem Fall ignoriert Mergemod.dll den Wert des ConfigData-Arguments und verwendet den Standardwert aus der Tabelle ModuleConfiguration.
[out] ConfigData
Das Tool sollte S_OK zurückgeben und den entsprechenden Anpassungstext in ConfigData bereitstellen. Das Clienttool ist für die Zuweisung der Daten verantwortlich, aber Mergemod.dll ist für die Freigabe des Arbeitsspeichers verantwortlich. Dieses Argument muss ein BSTR-Objekt sein. LPCWSTR wird nicht akzeptiert.
Rückgabewert
Jeder andere Rückgabecode als S_OK oder S_FALSE bewirkt, dass ein Fehler protokolliert wird (wenn ein Protokoll geöffnet ist) und zu einem Fehler beim Zusammenführen führt.
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.
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) | Mergemod.dll 2.0 oder höher |
| Zielplattform | Windows |
| Kopfzeile | mergemod.h |
| DLL | Mergemod.dll |