共用方式為

RpcMgmtIsServerListening 函式 (rpcdce.h)

  • 發行項

RpcMgmtIsServerListening 函式會告知伺服器是否正在接聽遠端過程調用。

語法

RPC_STATUS RpcMgmtIsServerListening(
  RPC_BINDING_HANDLE Binding
);

參數

Binding

若要判斷遠端應用程式是否正在接聽遠端過程調用，請指定該應用程式的伺服器系結句柄。 若要判斷您自己的 (本機) 應用程式是否正在接聽遠端過程調用，請指定 NULL 的值。

傳回值

值 意義
RPC_S_OK
 接聽遠端過程調用的伺服器。
RPC_S_NOT_LISTENING
 伺服器未接聽遠端過程調用，或介面正在自動接聽。
RPC_S_INVALID_BINDING
 系結句柄無效。
RPC_S_WRONG_KIND_OF_BINDING
 這是作業的系結錯誤種類。
 
注意 如需有效錯誤碼的清單，請參閱 RPC 傳回值。
 
 

RpcMgmtIsServerListening 函式只會針對未自動接聽的介面傳回正確的結果。 如果伺服器應用程式自動接聽並呼叫 RpcMgmtIsServerListening 函式， RpcMgmtIsServerListening 會傳回RPC_SERVER_NOT_LISTENING，但伺服器可能正在接聽，後續的 RPC 呼叫可能會成功。

備註

應用程式會呼叫 RpcMgmtIsServerListening 函式，以判斷 Binding 參數中指定的伺服器是否正在接聽遠端過程調用。

如果伺服器已呼叫 RpcServerListen，RpcMgmtIsServerListening 函式會傳回RPC_S_OK值。

伺服器必須接聽遠端過程調用，此函式才能成功。 如果伺服器未接聽，則函式會失敗。

規格需求

需求 值
最低支援的用戶端 Windows 2000 專業版 [傳統型應用程式 |UWP 應用程式]
最低支援的伺服器 Windows 2000 Server [傳統型應用程式 |UWP 應用程式]
目標平台 Windows
標頭 rpcdce.h (包含 Rpc.h)
程式庫 Rpcrt4.lib
Dll Rpcrt4.dll

另請參閱

RpcEpResolveBinding

RpcServerListen