Funzione RtmBlockMethods (rtmv2.h)

Articolo
03/01/2024

La funzione RtmBlockMethods blocca o sblocca l'esecuzione di metodi per una destinazione, una route o un hop successivo specificati o per tutte le destinazioni, route e hop successivi.

Sintassi

DWORD RtmBlockMethods(
  [in] RTM_ENTITY_HANDLE RtmRegHandle,
  [in] HANDLE            TargetHandle,
  [in] UCHAR             TargetType,
  [in] DWORD             BlockingFlag
);

Parametri

[in] RtmRegHandle

Gestire il client ottenuto da una chiamata precedente a RtmRegisterEntity.

[in] TargetHandle

Gestire in una destinazione, una route o un hop successivo per cui bloccare i metodi. Questo parametro è facoltativo e può essere impostato su NULL per bloccare i metodi per tutte le destinazioni.

[in] TargetType

Specifica il tipo dell'handle in TargetHandle. Questo parametro è facoltativo e può essere impostato su NULL per bloccare i metodi per tutte le destinazioni. Vengono usati i flag seguenti.

Type	Significato
DEST_TYPE	TargetHandle è una destinazione.
NEXTHOP_TYPE	TargetHandle è un hop successivo.
ROUTE_TYPE	TargetHandle è una route.

[in] BlockingFlag

Specifica se bloccare o sbloccare i metodi. Vengono usati i flag seguenti.

Costante	Significato
RTM_BLOCK_METHODS	Blocca i metodi per la destinazione specificata.
RTM_RESUME_METHODS	Sbloccare i metodi per la destinazione specificata.

Valore restituito

Se la funzione ha esito positivo, il valore restituito è NO_ERROR.

Se la funzione ha esito negativo, il valore restituito è il codice di errore seguente.

Valore	Significato
ERROR_INVALID_HANDLE	Handle non valido.

Commenti

Attualmente questa funzione non supporta i metodi di blocco per una destinazione, una route o un hop successivo specifici.

I metodi vengono in genere bloccati quando vengono modificati dati specifici del client nella route; un client blocca i metodi, riorganizzerà i dati e quindi sblocca i metodi.

I client devono bloccare solo i metodi per un breve periodo di tempo. Se un secondo client chiama RtmInvokeMethod e i metodi del primo client vengono bloccati, RtmInvokeMethod non restituisce finché non vengono sbloccati i metodi e la chiamata alla funzione viene completata.

Requisiti

Requisito	Valore
Client minimo supportato	Nessuno supportato
Server minimo supportato	Windows 2000 Server [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	rtmv2.h
Libreria	Rtm.lib
DLL	Rtm.dll

Vedi anche

RtmGetEntityMethods

RtmInvokeMethod

Condividi tramite