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

Статья
11/20/2024

Функция RpcNsGroupMbrAdd добавляет имя записи в группу. При необходимости он создает запись.

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

Синтаксис

RPC_STATUS RpcNsGroupMbrAddW(
  unsigned long GroupNameSyntax,
  RPC_WSTR      GroupName,
  unsigned long MemberNameSyntax,
  RPC_WSTR      MemberName
);

Параметры

GroupNameSyntax

Синтаксис GroupName.

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

GroupName

Указатель на имя группы RPC для получения нового члена.

MemberNameSyntax

Синтаксис для использования в MemberName.

MemberName

Указатель на имя нового члена группы RPC.

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

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

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

Замечания

RpcNsGroupMbrAdd добавляет имя записи службы-базы данных в качестве члена в атрибут группы RPC.

Если запись groupName не существует, RpcNsGroupMbrAd d пытается создать запись с атрибутом группы и добавляет член группы, указанный MemberName. В этом случае приложение должно иметь права на создание записи. В противном случае приложение управления с необходимыми привилегиями должно создать запись, вызвав RpcNsMgmtEntryCreate перед запуском приложения.

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

Заметка

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

Требования

Требование	Ценность
минимальные поддерживаемые клиентские	Windows 2000 Профессиональный [только классические приложения]
минимальный поддерживаемый сервер	Windows 2000 Server [только классические приложения]
целевая платформа	Виндоус
заголовка	rpcnsi.h (include Rpc.h)
библиотеки	Rpcns4.lib
DLL	Rpcns4.dll

См. также

RpcNsGroupMbrRemove

RpcNsMgmtEntryCreate

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