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

Статья
08/25/2023

Функция RpcNsProfileDelete удаляет атрибут профиля.

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

Синтаксис

RPC_STATUS RpcNsProfileDeleteA(
  unsigned long ProfileNameSyntax,
  RPC_CSTR      ProfileName
);

Параметры

ProfileNameSyntax

Целочисленное значение, указывающее синтаксис следующего параметра ProfileName.

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

ProfileName

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

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

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

Функция RpcNsProfileDelete удаляет атрибут профиля из указанной записи name-service (ProfileName). Ни ProfileName, ни имена записей, включенных в качестве членов в каждом элементе профиля, не удаляются.

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

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

Примечание

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

Требования

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

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

RpcNsProfileEltAdd

RpcNsProfileEltRemove

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