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

Статья
11/20/2024

Функция RpcNsGroupMbrInqNext возвращает одно имя записи из группы одновременно.

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

Синтаксис

RPC_STATUS RpcNsGroupMbrInqNextA(
  RPC_NS_HANDLE InquiryContext,
  RPC_CSTR      *MemberName
);

Параметры

InquiryContext

Дескриптор службы имен.

MemberName

Возвращает адрес указателя на имя члена группы RPC. Синтаксис возвращаемого имени был указан параметром MemberNameSyntax в функции RpcNsGroupMbrInqBegin.

Укажите значение NULL, чтобы предотвратить RpcNsGroupMbrInqNext возвращать параметр MemberName. В этом случае приложение не вызывает функцию RpcStringFree.

Возвращаемое значение

Ценность	Значение
RPC_S_OK	Вызов выполнен успешно.
RPC_S_INVALID_NS_HANDLE	Недопустимый дескриптор службы имен.
RPC_S_NO_MORE_MEMBERS	Больше нет участников.
RPC_S_NAME_SERVICE_UNAVAILABLE	Служба имен недоступна.

Примечание Список допустимых кодов ошибок см. в разделе возвращаемых значений RPC.

Замечания

Функция RpcNsGroupMbrInqNext возвращает один из членов группы RPC, указанной параметром groupName в RpcNsGroupMbrInqBegin. Приложение может просматривать все члены группы RPC, устанавливая несколько вызовов RpcNsGroupMbrInqNext. Когда все члены группы были просмотрены, эта функция возвращает код состояния RPC_S_NO_MORE_MEMBERS. Возвращаемые члены группы не упорядочены.

При каждом вызове RpcNsGroupMbrInqNext, возвращающей имя члена, библиотека времени выполнения RPC выделяет память для возвращаемого Имени участника. Приложение отвечает за вызов RpcStringFree для каждой возвращаемой строки MemberName. После просмотра членов группы RPC приложение должно вызвать RpcNsGroupMbrInqDone, чтобы освободить контекст запроса.

Порядок возврата элементов группы может отличаться для каждого просмотра группы. Это означает, что порядок возврата членов группы в приложение может отличаться при каждом запуске приложения.

примечание Windows 2000 Active Directory поддерживает эту функцию. Более ранние версии Windows NT поддерживают использование этой функции только со службой каталогов ячеек (CDS).

Заметка

Заголовок rpcnsi.h определяет RpcNsGroupMbrInqNext как псевдоним, который автоматически выбирает версию ANSI или Юникод этой функции на основе определения константы препроцессора ЮНИКОДа. Сочетание использования псевдонима, нейтрального для кодирования, с кодом, не зависящим от кодирования, может привести к несоответствиям, которые приводят к ошибкам компиляции или среды выполнения. Дополнительные сведения см. в соглашениях о прототипах функций.

Требования

Требование	Ценность
минимальные поддерживаемые клиентские	Windows 2000 Профессиональный [только классические приложения]
минимальный поддерживаемый сервер	Windows 2000 Server [только классические приложения]
целевая платформа	Виндоус
заголовка	rpcnsi.h (include Rpc.h)
библиотеки	Rpcns4.lib
DLL	Rpcns4.dll

См. также

RpcNsGroupMbrInqBegin

RpcNsGroupMbrInqDone

RpcStringFree

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