Функция RpcNsGroupMbrInqNextA (rpcnsi.h)
Функция RpcNsGroupMbrInqNext возвращает одно имя записи из группы за раз.
Синтаксис
RPC_STATUS RpcNsGroupMbrInqNextA(
RPC_NS_HANDLE InquiryContext,
RPC_CSTR *MemberName
);
Параметры
InquiryContext
Дескриптор службы имен.
MemberName
Возвращает адрес указателя на имя члена группы RPC. Синтаксис возвращаемого имени был указан с помощью параметра MemberNameSyntax в функции RpcNsGroupMbrInqBegin .
Укажите значение NULL, чтобы запретить RpcNsGroupMbrInqNext возвращать параметр MemberName . В этом случае приложение не вызывает функцию RpcStringFree .
Возвращаемое значение
Значение | Значение |
---|---|
|
Вызов выполнен успешно. |
|
Недопустимый дескриптор name-service. |
|
Больше нет членов. |
|
Служба имен недоступна. |
Комментарии
Функция RpcNsGroupMbrInqNext возвращает один член группы RPC, указанной параметром GroupName в RpcNsGroupMbrInqBegin. Приложение может просматривать все члены группы RPC, заданной путем многократного вызова RpcNsGroupMbrInqNext. При просмотре всех членов группы эта функция возвращает код состояния RPC_S_NO_MORE_MEMBERS. Возвращаемые члены группы не упорядочены.
При каждом вызове RpcNsGroupMbrInqNext , который возвращает имя члена, библиотека времени выполнения RPC выделяет память для возвращаемого memberName. Приложение отвечает за вызов RpcStringFree для каждой возвращаемой строки MemberName . После просмотра участников группы RPC приложение должно вызвать RpcNsGroupMbrInqDone , чтобы освободить контекст запроса.
Порядок, в котором возвращаются участники группы, может быть разным для каждого просмотра группы. Это означает, что порядок, в котором участники группы возвращаются в приложение, может отличаться при каждом запуске приложения.
Примечание
Заголовок rpcnsi.h определяет RpcNsGroupMbrInqNext в качестве псевдонима, который автоматически выбирает версию ANSI или Юникод этой функции на основе определения константы препроцессора ЮНИКОД. Использование псевдонима, не зависящий от кодирования, с кодом, который не является нейтральным для кодировки, может привести к несоответствиям, которые приводят к ошибкам компиляции или времени выполнения. Дополнительные сведения см. в разделе Соглашения для прототипов функций.
Требования
Минимальная версия клиента | Windows 2000 Professional [только классические приложения] |
Минимальная версия сервера | Windows 2000 Server [только классические приложения] |
Целевая платформа | Windows |
Header | rpcnsi.h (включая Rpc.h) |
Библиотека | Rpcns4.lib |
DLL | Rpcns4.dll |
См. также раздел
Обратная связь
https://aka.ms/ContentUserFeedback.
Ожидается в ближайшее время: в течение 2024 года мы постепенно откажемся от GitHub Issues как механизма обратной связи для контента и заменим его новой системой обратной связи. Дополнительные сведения см. в разделеОтправить и просмотреть отзыв по