Función RpcNsGroupMbrInqNextA (rpcnsi.h)

La función RpcNsGroupMbrInqNext devuelve un nombre de entrada de un grupo a la vez.

Nota Esta función no se admite en Windows Vista ni en sistemas operativos posteriores.

 

Sintaxis

RPC_STATUS RpcNsGroupMbrInqNextA(
  RPC_NS_HANDLE InquiryContext,
  RPC_CSTR      *MemberName
);

Parámetros

InquiryContext

Identificador de servicio de nombres.

MemberName

Devuelve la dirección de un puntero a un nombre de miembro del grupo RPC. La sintaxis del nombre devuelto se especificó mediante el parámetro MemberNameSyntax en la función RpcNsGroupMbrInqBegin.

Especifique un valor NULL para evitar que rpcNsGroupMbrInqNext devuelva el parámetro MemberName de . En este caso, la aplicación no llama a la función RpcStringFree.

Valor devuelto

Valor	Significado
RPC_S_OK	La llamada se realizó correctamente.
RPC_S_INVALID_NS_HANDLE	El identificador name-service no es válido.
RPC_S_NO_MORE_MEMBERS	No más miembros.
RPC_S_NAME_SERVICE_UNAVAILABLE	El servicio de nombre no está disponible.

 

Nota Para obtener una lista de códigos de error válidos, vea rpc Return Values.

 

Observaciones

La función rpcNsGroupMbrInqNext devuelve un miembro del grupo RPC especificado por el parámetro GroupName de en RpcNsGroupMbrInqBegin. Una aplicación puede ver todos los miembros de un grupo RPC establecido llamando repetidamente a RpcNsGroupMbrInqNext. Cuando se han visto todos los miembros del grupo, esta función devuelve un código de estado RPC_S_NO_MORE_MEMBERS. Los miembros del grupo devueltos no están ordenados.

En cada llamada a RpcNsGroupMbrInqNext que devuelve un nombre de miembro, la biblioteca en tiempo de ejecución rpc asigna memoria para la MemberName devuelta. La aplicación es responsable de llamar a RpcStringFree para cada cadena de MemberName devuelta. Después de ver los miembros del grupo RPC, la aplicación debe llamar a RpcNsGroupMbrInqDone para liberar el contexto de consulta.

El orden en el que se devuelven los miembros del grupo puede ser diferente para cada visualización de un grupo. Esto significa que el orden en el que se devuelven los miembros del grupo a una aplicación puede ser diferente cada vez que se ejecuta la aplicación.

Nota Windows 2000 Active Directory admite esta función. Las versiones anteriores de Windows NT solo admiten el uso de esta función con cell Directory Service (CDS).

 

Nota

El encabezado rpcnsi.h define RpcNsGroupMbrInqNext como alias que selecciona automáticamente la versión ANSI o Unicode de esta función en función de la definición de la constante de preprocesador UNICODE. La combinación del uso del alias neutral de codificación con código que no es neutral de codificación puede dar lugar a errores de coincidencia que dan lugar a errores de compilación o tiempo de ejecución. Para obtener más información, vea Conventions for Function Prototypes.

Requisitos

Requisito	Valor
cliente mínimo admitido	Windows 2000 Professional [solo aplicaciones de escritorio]
servidor mínimo admitido	Windows 2000 Server [solo aplicaciones de escritorio]
de la plataforma de destino de	Windows
encabezado de	rpcnsi.h (include Rpc.h)
biblioteca de	Rpcns4.lib
DLL de	Rpcns4.dll

Consulte también

rpcNsGroupMbrInqBegin

rpcNsGroupMbrInqDone

RpcStringFree