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

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

  • Статья

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

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

Синтаксис

RPC_STATUS RpcNsEntryExpandNameW(
  unsigned long EntryNameSyntax,
  RPC_WSTR      EntryName,
  RPC_WSTR      *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 Professional [только классические приложения]
Минимальная версия сервера Windows 2000 Server [только классические приложения]
Целевая платформа Windows
Header rpcnsi.h (включая Rpc.h)
Библиотека Rpcns4.lib
DLL Rpcns4.dll

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

RpcStringFree