Функция RpcNsEntryObjectInqBeginW (rpcnsi.h)
Функция RpcNsEntryObjectInqBegin создает контекст запроса для объектов записи базы данных службы имен.
Синтаксис
RPC_STATUS RpcNsEntryObjectInqBeginW(
unsigned long EntryNameSyntax,
RPC_WSTR EntryName,
RPC_NS_HANDLE *InquiryContext
);
Параметры
EntryNameSyntax
Синтаксис для использования в EntryName.
Чтобы использовать синтаксис, указанный в записи значения реестра HKEY_LOCAL_MACHINE\Software\Microsoft\Rpc\NameService\DefaultSyntax, укажите значение RPC_C_NS_SYNTAX_DEFAULT.
EntryName
Указатель на имя записи базы данных name-service, для которой необходимо просмотреть идентификаторы UUID объекта.
InquiryContext
Возвращает указатель на дескриптор службы имен для использования с функциями RpcNsEntryObjectInqNext и RpcNsEntryObjectInqDone .
Возвращаемое значение
Значение | Значение |
---|---|
|
Вызов выполнен успешно. |
|
Недопустимый синтаксис имени. |
|
Синтаксис имени не поддерживается. |
|
Имя является неполным. |
|
Запись name-service не найдена. |
|
Служба имен недоступна. |
Комментарии
Функция RpcNsEntryObjectInqBegin создает контекст запроса для просмотра идентификаторов UUID объекта, экспортированных в EntryName.
Перед вызовом функции RpcNsEntryObjectInqNext приложение должно сначала вызвать RpcNsEntryObjectInqBegin , чтобы создать контекст запроса.
По завершении просмотра идентификаторов UUID объекта приложение вызывает функцию RpcNsEntryObjectInqDone для удаления контекста запроса.
Примечание
Заголовок rpcnsi.h определяет RpcNsEntryObjectInqBegin в качестве псевдонима, который автоматически выбирает версию ANSI или Юникод этой функции на основе определения константы препроцессора UNICODE. Сочетание использования псевдонима, не зависящий от кодировки, с кодом, не зависящим от кодировки, может привести к несоответствиям, которые приводят к ошибкам компиляции или среды выполнения. Дополнительные сведения см. в разделе Соглашения для прототипов функций.
Требования
Требование | Значение |
---|---|
Минимальная версия клиента | Windows 2000 Professional [только классические приложения] |
Минимальная версия сервера | Windows 2000 Server [только классические приложения] |
Целевая платформа | Windows |
Header | rpcnsi.h (включая Rpc.h) |
Библиотека | Rpcns4.lib |
DLL | Rpcns4.dll |
См. также раздел
Обратная связь
https://aka.ms/ContentUserFeedback.
Ожидается в ближайшее время: в течение 2024 года мы постепенно откажемся от GitHub Issues как механизма обратной связи для контента и заменим его новой системой обратной связи. Дополнительные сведения см. в разделеОтправить и просмотреть отзыв по