Funzione RpcMgmtIsServerListening (rpcdce.h)
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 |
|---|---|
|
Server in ascolto delle chiamate di procedura remota. |
|
Il server non è in ascolto delle chiamate di procedura remota o l'interfaccia è in ascolto automatico. |
|
L'handle di associazione non è valido. |
|
Questo è stato il tipo di associazione sbagliato per l'operazione. |
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 |