Share via

Funzione RpcMgmtIsServerListening (rpcdce.h)

  • Articolo

La funzione RpcMgmtIsServerListening indica se un server è in ascolto delle chiamate di routine remote.

Sintassi

RPC_STATUS RpcMgmtIsServerListening(
  RPC_BINDING_HANDLE Binding
);

Parametri

Binding

Per determinare se un'applicazione remota è in ascolto delle chiamate di routine remote, specificare un handle di associazione server per tale applicazione. Per determinare se l'applicazione locale è in ascolto per le chiamate di routine remote, specificare un valore NULL.

Valore restituito

Valore Significato
RPC_S_OK
 Server in ascolto delle chiamate di procedura remota.
RPC_S_NOT_LISTENING
 Il server non è in ascolto delle chiamate di procedura remota o l'interfaccia è in ascolto automatico.
RPC_S_INVALID_BINDING
 L'handle di associazione non è valido.
RPC_S_WRONG_KIND_OF_BINDING
 Questo è stato il tipo di associazione sbagliato per l'operazione.
 
Nota Per un elenco di codici di errore validi, vedere Valori restituiti RPC.
 
 

La funzione RpcMgmtIsServerListening restituisce risultati corretti solo per le interfacce che non sono in ascolto automatico. Se l'applicazione server è in ascolto automatico e chiama la funzione RpcMgmtIsServerListening, RpcMgmtIsServerListening restituisce RPC_SERVER_NOT_LISTENING, ma il server potrebbe essere in ascolto e le chiamate RPC successive potrebbero avere esito positivo.

Commenti

Un'applicazione chiama la funzione RpcMgmtIsServerListening per determinare se il server specificato nel parametro Binding è in ascolto delle chiamate di routine remote.

La funzione RpcMgmtIsServerListening restituisce un valore di RPC_S_OK se il server ha chiamato RpcServerListen.

Il server deve essere in ascolto delle chiamate di routine remote per la riuscita di questa funzione. Se il server non è in ascolto, la funzione ha esito negativo.

Requisiti

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

Vedi anche

RpcEpResolveBinding

RpcServerListen