Funzione RpcMgmtStopServerListening (rpcdce.h)

La funzione RpcMgmtStopServerListening indica a un server di interrompere l'ascolto delle chiamate di procedura remota. Questa funzione non influirà sulle interfacce di ascolto automatico. Per altri dettagli , vedere RpcServerRegisterIfEx .

Sintassi

RPC_STATUS RpcMgmtStopServerListening(
  RPC_BINDING_HANDLE Binding
);

Parametri

Binding

Per indirizzare un'applicazione remota a interrompere l'ascolto delle chiamate di procedura remota, specificare un handle di associazione server per tale applicazione. Per indirizzare l'applicazione (locale) a interrompere l'ascolto per le chiamate di routine remote, specificare il valore NULL.

Valore restituito

Valore	Significato
RPC_S_OK	La chiamata ha avuto esito positivo.
RPC_S_INVALID_BINDING	Handle di associazione non valido.
RPC_S_WRONG_KIND_OF_BINDING	Si tratta del tipo di binding errato per l'operazione.

 

Nota Per un elenco di codici di errore validi, vedere Valori restituiti RPC.

 

Commenti

Un'applicazione chiama la funzione RpcMgmtStopServerListening per indirizzare un server a interrompere l'ascolto delle chiamate di procedura remota. Se DontWait è TRUE, l'applicazione deve chiamare RpcMgmtWaitServerListen per attendere il completamento di tutte le chiamate.

Quando riceve una richiesta di arresto dell'ascolto, la libreria di runtime RPC smette di accettare nuove chiamate di routine remota per tutte le interfacce registrate. L'esecuzione di chiamate può essere completata, inclusi i callback. Al termine di tutte le chiamate, questa funzione segnala alla funzione RpcServerListen che deve arrestare l'ascolto e tornare al chiamante. Se il parametro DontWait di RpcServerListen è stato impostato su TRUE, l'applicazione chiama RpcMgmtWaitServerListen per tutte le chiamate rimanenti da completare.

Nota Dal lato client , RpcMgmtStopServerListening è disabilitato per impostazione predefinita. Per abilitare questa funzione, creare una funzione di autorizzazione nell'applicazione server che restituisce TRUE (per consentire un arresto remoto) ogni volta che viene chiamato RpcMgmtStopServerListening . Usare RpcMgmtSetAuthorizationFn per concedere al client l'accesso alla funzione di gestione.

 

Affinché questa funzione abbia esito positivo, il server deve essere in ascolto delle chiamate di routine remote. Se il server non è in ascolto, la funzione ha esito negativo.

Requisiti

Client minimo supportato	Windows 2000 Professional [solo app desktop]
Server minimo supportato	Windows 2000 Server [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	rpcdce.h (include Rpc.h)
Libreria	Rpcrt4.lib
DLL	Rpcrt4.dll

Vedi anche

RpcEpResolveBinding

RpcMgmtWaitServerListen

RpcServerListen

RpcServerRegisterIfEx