Функция RpcNsMgmtEntryDeleteW (rpcnsi.h)

Статья
08/25/2023

Функция RpcNsMgmtEntryDelete удаляет запись service-database.

Примечание Эта функция не поддерживается в операционных системах Windows Vista и более поздних версий.

Синтаксис

RPC_STATUS RpcNsMgmtEntryDeleteW(
  unsigned long EntryNameSyntax,
  RPC_WSTR      EntryName
);

Параметры

EntryNameSyntax

Синтаксис entryName.

Чтобы использовать синтаксис, указанный в записи значения реестра HKEY_LOCAL_MACHINE\Software\Microsoft\Rpc\NameService\DefaultSyntax, укажите значение RPC_C_NS_SYNTAX_DEFAULT.

EntryName

Указатель на имя удаляемой записи.

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

Значение	Значение
RPC_S_OK	Вызов выполнен успешно.
RPC_S_INVALID_NAME_SYNTAX	Недопустимый синтаксис имени.
RPC_S_UNSUPPORTED_NAME_SYNTAX	Синтаксис имени не поддерживается.
RPC_S_INCOMPLETE_NAME	Имя является неполным.
RPC_S_ENTRY_NOT_FOUND	Запись name-service не найдена.
RPC_S_NAME_SERVICE_UNAVAILABLE	Служба имен недоступна.
RPC_S_NOT_RPC_ENTRY	Не запись RPC.

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

Приложения управления используют функцию RpcNsMgmtEntryDelete только в том случае, если запись больше не требуется, например, когда сервер окончательно удаляется из службы.

Так как базы данных службы имен являются относительно стабильными, частое использование RpcNsMgmtEntryDelete в клиентских или серверных приложениях может привести к проблемам с производительностью. Создание и удаление записей в клиентских или серверных приложениях приводит к повторному удалению и замене одной и той же записи из базы данных службы имен. Это может привести к проблемам с производительностью в реплицированных базах данных службы имен.

Примечание

Заголовок rpcnsi.h определяет RpcNsMgmtEntryDelete как псевдоним, который автоматически выбирает версию ANSI или Юникод этой функции на основе определения константы препроцессора UNICODE. Сочетание использования псевдонима, не зависящий от кодировки, с кодом, не зависящим от кодировки, может привести к несоответствиям, которые приводят к ошибкам компиляции или среды выполнения. Дополнительные сведения см. в разделе Соглашения для прототипов функций.

Требования

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

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

RpcNsMgmtEntryCreate

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