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 del 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 . 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 nombre del servicio no está disponible.

 

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

 

Comentarios

La función RpcNsGroupMbrInqNext devuelve un miembro del grupo RPC especificado por el parámetro GroupName 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 el MemberName devuelto. La aplicación es responsable de llamar a RpcStringFree para cada cadena 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 que se devuelven los miembros del grupo puede ser diferente para cada visualización de un grupo. Esto significa que el orden en que se devuelven los miembros del grupo a una aplicación puede ser diferente cada vez que se ejecuta la aplicación.

Nota Active Directory de Windows 2000 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 Convenciones para prototipos de función.

Requisitos

Cliente mínimo compatible	Windows 2000 Professional [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows 2000 Server [solo aplicaciones de escritorio]
Plataforma de destino	Windows
Encabezado	rpcnsi.h (incluir Rpc.h)
Library	Rpcns4.lib
Archivo DLL	Rpcns4.dll

Consulte también

RpcNsGroupMbrInqBegin

RpcNsGroupMbrInqDone

RpcStringFree