RtmGetEntityMethods-Funktion (rtmv2.h)
Die RtmGetEntityMethods-Funktion fragt den angegebenen Client ab, um zu bestimmen, welche Methoden für einen anderen Client verfügbar sind.
Syntax
DWORD RtmGetEntityMethods(
[in] RTM_ENTITY_HANDLE RtmRegHandle,
[in] RTM_ENTITY_HANDLE EntityHandle,
[in, out] PUINT NumMethods,
[out] PRTM_ENTITY_EXPORT_METHOD ExptMethods
);
Parameter
[in] RtmRegHandle
Handle an den Client, der von einem vorherigen Aufruf von RtmRegisterEntity abgerufen wurde.
[in] EntityHandle
Handle an den Client, für den Methoden abgerufen werden sollen.
[in, out] NumMethods
NumMethods gibt bei der Eingabe einen gültigen Zeiger auf einen UINT-Wert an. Geben Sie null an, um die Anzahl der Methoden zurückzugeben, die exportiert werden können.
Bei der Ausgabe empfängt NumMethods die Anzahl der Methoden, die vom Client exportiert werden.
[out] ExptMethods
Empfängt einen Zeiger auf eine RTM_ENTITY_EXPORT_METHOD Struktur, die den Satz von Methodenbezeichnern enthält, die vom aufrufenden Client angefordert werden.
Rückgabewert
Wenn die Funktion erfolgreich ist, wird der Rückgabewert NO_ERROR.
Wenn die Funktion fehlschlägt, ist der Rückgabewert einer der folgenden Fehlercodes.
| Wert | Bedeutung |
|---|---|
|
Der bereitgestellte Puffer ist nicht groß genug, um alle angeforderten Informationen zu enthalten. |
Hinweise
Rufen Sie die Methode eines anderen Clients nicht direkt auf, verwenden Sie immer RtmInvokeMethod. Der Routingtabellen-Manager führt bei Verwendung von RtmInvokeMethod eine Fehlerüberprüfung durch, um sicherzustellen, dass die Registrierung des Clients nicht aufgehoben oder die Registrierung bereits aufgehoben wird.
Wenn ERROR_INSUFFICIENT_BUFFER zurückgegeben wird, können einige Daten in ExptMethods vorhanden sein. NumMethods gibt an, wie viele Methoden tatsächlich in den Puffer passen.
Wenn das Entitätshandle nicht mehr erforderlich ist, geben Sie es durch Aufrufen von RtmReleaseEntities frei.
Beispielcode mit dieser Funktion finden Sie unter Abrufen und Aufrufen der exportierten Methoden für einen Client.
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) | Nicht unterstützt |
| Unterstützte Mindestversion (Server) | Windows 2000 Server [nur Desktop-Apps] |
| Zielplattform | Windows |
| Kopfzeile | rtmv2.h |
| Bibliothek | Rtm.lib |
| DLL | Rtm.dll |