RtmReferenceHandles-Funktion (rtmv2.h)

Artikel
03/04/2024

Die RtmReferenceHandles-Funktion erhöht die Verweisanzahl für Objekte, auf die von einem oder mehreren Handles verwiesen wird, die der Routing-Manager für den Zugriff auf diese Objekte verwendet hat. Ein Client sollte diese Funktion verwenden, wenn der Client ein Handle beibehalten muss, aber den Rest der dem Handle zugeordneten Informationsstruktur freigeben muss.

Syntax

DWORD RtmReferenceHandles(
  [in] RTM_ENTITY_HANDLE RtmRegHandle,
  [in] UINT              NumHandles,
  [in] HANDLE            *RtmHandles
);

Parameter

[in] RtmRegHandle

Handle an den Client, der von einem vorherigen Aufruf von RtmRegisterEntity abgerufen wurde.

[in] NumHandles

Gibt die Anzahl der Handles in RtmHandles an.

[in] RtmHandles

Array von Handles, für die die Verweisanzahl erhöht werden soll.

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
ERROR_INVALID_HANDLE	Das Handle ist ungültig.

Hinweise

Ein Client muss diese Funktion immer aufrufen, wenn ein vom Routingtabellen-Manager zurückgegebenes Handle zwischengespeichert wird. Dadurch wird der Routingtabellen-Manager benachrichtigt, dass er das Objekt, auf das sich das Handle bezieht, erst zerstören soll, wenn das Handle vom Client freigegeben wird.

Wenn ein Client das Handle freigeben muss, muss der Client basierend auf dem Typ des Handles die entsprechende Releasefunktion aufrufen. Rufen Sie beispielsweise RtmReleaseRoutes auf, um eine Route freizugeben.

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