Функция RpcMgmtStopServerListening (rpcdce.h)

Статья
08/25/2023

Функция RpcMgmtStopServerListening сообщает серверу прекратить прослушивание удаленных вызовов процедур. Эта функция не влияет на интерфейсы автоматического прослушивания. Дополнительные сведения см. в разделе RpcServerRegisterIfEx .

Синтаксис

RPC_STATUS RpcMgmtStopServerListening(
  RPC_BINDING_HANDLE Binding
);

Параметры

Binding

Чтобы указать удаленному приложению прекратить прослушивание вызовов удаленных процедур, укажите дескриптор привязки сервера для этого приложения. Чтобы настроить собственное (локальное) приложение для прекращения прослушивания удаленных вызовов процедур, укажите значение NULL.

Возвращаемое значение

Значение	Значение
RPC_S_OK	Вызов выполнен успешно.
RPC_S_INVALID_BINDING	Недопустимый дескриптор привязки.
RPC_S_WRONG_KIND_OF_BINDING	Это была неправильная привязка для операции.

Примечание Список допустимых кодов ошибок см. в разделе Возвращаемые значения RPC.

Приложение вызывает функцию RpcMgmtStopServerListening , чтобы направить сервер на прекращение прослушивания удаленных вызовов процедур. Если параметр DontWait имеет значение TRUE, приложение должно вызвать RpcMgmtWaitServerListen , чтобы дождаться завершения всех вызовов.

При получении запроса на остановку прослушивания библиотека времени выполнения RPC перестает принимать новые вызовы удаленных процедур для всех зарегистрированных интерфейсов. Выполнение вызовов разрешено, включая обратные вызовы. После завершения всех вызовов эта функция сообщает функции RpcServerListen , что она должна прекратить прослушивание и вернуться вызывающему объекту. Если параметру DontWaitобъекта RpcServerListen присвоено значение TRUE, приложение вызывает RpcMgmtWaitServerListen для завершения всех оставшихся вызовов.

Примечание На стороне клиента RpcMgmtStopServerListening отключен по умолчанию. Чтобы включить эту функцию, создайте в серверном приложении функцию авторизации, которая возвращает значение TRUE (чтобы разрешить удаленное завершение работы) при каждом вызове RpcMgmtStopServerListening . Используйте RpcMgmtSetAuthorizationFn , чтобы предоставить клиенту доступ к функции управления.

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

Требования


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

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

RpcEpResolveBinding

RpcMgmtWaitServerListen

RpcServerListen

RpcServerRegisterIfEx

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