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

Статья
11/20/2024

Функция RpcNsEntryExpandName расширяет имя записи службы имен. Эта функция поддерживается Active Directory.

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

Синтаксис

RPC_STATUS RpcNsEntryExpandNameA(
  unsigned long EntryNameSyntax,
  RPC_CSTR      EntryName,
  RPC_CSTR      *ExpandedName
);

Параметры

EntryNameSyntax

Синтаксис EntryName.

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

EntryName

Указатель на имя записи для развертывания.

ExpandedName

Возвращает указатель на указатель на развернутую версию EntryName.

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

Ценность	Значение
RPC_S_OK	Вызов выполнен успешно.
RPC_S_INCOMPLETE_NAME	Имя является неполным.

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

Замечания

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

Библиотека времени выполнения RPC выделяет память для возвращаемого параметра ExpandedName. Приложение отвечает за вызов функции RpcStringFree для этой возвращаемой строки.

Возвращаемые развернутые учетные записи имен для перевода локальных имен и различия в локально определенной схеме именования.

Примечание Эта функция требует поддержки Active Directory.

Заметка

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

Требования

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

См. также

RpcStringFree

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