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

Статья
03/01/2024

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

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

Синтаксис

RPC_STATUS RpcNsGroupMbrInqNextW(
  RPC_NS_HANDLE InquiryContext,
  RPC_WSTR      *MemberName
);

Параметры

InquiryContext

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

MemberName

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

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

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

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

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

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

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

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

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

Примечание

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

Требования

Требование	Значение
Минимальная версия клиента	Windows 2000 Professional [только классические приложения]
Минимальная версия сервера	Windows 2000 Server [только классические приложения]
Целевая платформа	Windows
Header	rpcnsi.h (включая Rpc.h)
Библиотека	Rpcns4.lib
DLL	Rpcns4.dll

См. также раздел

RpcNsGroupMbrInqBegin

RpcNsGroupMbrInqDone

RpcStringFree

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