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