Функция RpcNsEntryExpandNameA (rpcnsi.h)
Функция RpcNsEntryExpandName расширяет имя записи name-service. Эта функция поддерживается Active Directory.
Синтаксис
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.
Возвращаемое значение
Значение | Значение |
---|---|
|
Вызов выполнен успешно. |
|
Имя является неполным. |
Комментарии
Приложение вызывает функцию RpcNsEntryExpandName , чтобы получить полностью развернутое имя записи.
Библиотека времени выполнения RPC выделяет память для возвращаемого параметра ExpandedName . Приложение отвечает за вызов функции RpcStringFree для возвращаемой строки.
Возвращенное расширенное имя записи учитывает локальные преобразования имен и различия в локально определяемой схеме именования.
Примечание
Заголовок rpcnsi.h определяет RpcNsEntryExpandName в качестве псевдонима, который автоматически выбирает версию ANSI или Юникод этой функции на основе определения константы препроцессора ЮНИКОД. Сочетание использования псевдонима, не зависящий от кодировки, с кодом, не зависящим от кодировки, может привести к несоответствиям, которые приводят к ошибкам компиляции или среды выполнения. Дополнительные сведения см. в разделе Соглашения для прототипов функций.
Требования
Требование | Значение |
---|---|
Минимальная версия клиента | Windows 2000 Professional [только классические приложения] |
Минимальная версия сервера | Windows 2000 Server [только классические приложения] |
Целевая платформа | Windows |
Header | rpcnsi.h (включая Rpc.h) |
Библиотека | Rpcns4.lib |
DLL | Rpcns4.dll |