Поделиться через

Функция 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 , удаленные вызовы процедур.

Функция RpcMgmtIsServerListening возвращает значение RPC_S_OK , если сервер вызвал RpcServerListen.

Сервер должен прослушивать удаленные вызовы процедур, чтобы эта функция была успешной. Если сервер не прослушивает, функция завершается ошибкой.

Требования

Требование Значение
Минимальная версия клиента Windows 2000 Профессиональная [классические приложения | Приложения UWP]
Минимальная версия сервера Windows 2000 Server [классические приложения | Приложения UWP]
Целевая платформа Windows
Header rpcdce.h (включая Rpc.h)
Библиотека Rpcrt4.lib
DLL Rpcrt4.dll

См. также раздел

RpcEpResolveBinding

RpcServerListen