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

Статья
03/15/2023

Функция RpcNsProfileEltRemove удаляет элемент из профиля.

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

Синтаксис

RPC_STATUS RpcNsProfileEltRemoveW(
  unsigned long ProfileNameSyntax,
  RPC_WSTR      ProfileName,
  RPC_IF_ID     *IfId,
  unsigned long MemberNameSyntax,
  RPC_WSTR      MemberName
);

Параметры

ProfileNameSyntax

Синтаксис profileName.

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

ProfileName

Указатель на имя профиля, из которого удаляется элемент.

IfId

Указатель на идентификацию интерфейса удаляемого элемента профиля.

Укажите значение NULL, чтобы удалить элемент профиля по умолчанию.

MemberNameSyntax

Синтаксис memberName.

MemberName

Указатель на имя service-entry name в удаляемом элементе профиля.

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

Значение	Значение
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.

Функция RpcNsProfileEltRemove удаляет элемент профиля из атрибута профиля в записи ProfileName . Для удаления элемента профиля этой функции требуется точное соответствие параметров MemberName и IfId . Запись (MemberName), включенная в элемент профиля в качестве элемента, не удаляется.

Примечание Осторожно используйте RpcNsProfileEltRemove : удаление элементов из профиля может иметь нежелательный эффект нарушения иерархии профилей.

Примечание Windows 2000 Active Directory поддерживает эту функцию. Более ранние версии Windows NT поддерживают использование этой функции только со службой каталогов ячеек (CDS).

Примечание

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

Требования

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

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

RpcNsProfileDelete

RpcNsProfileEltAdd

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