Função RpcNsGroupMbrInqNextW (rpcnsi.h)

Artigo
11/20/2024

A função RpcNsGroupMbrInqNext retorna um nome de entrada de um grupo de cada vez.

Observação Essa função não tem suporte no Windows Vista e em sistemas operacionais posteriores.

Sintaxe

RPC_STATUS RpcNsGroupMbrInqNextW(
  RPC_NS_HANDLE InquiryContext,
  RPC_WSTR      *MemberName
);

Parâmetros

InquiryContext

Identificador de serviço de nome.

MemberName

Retorna o endereço de um ponteiro para um nome de membro do grupo RPC. A sintaxe do nome retornado foi especificada pelo parâmetro MemberNameSyntax na função RpcNsGroupMbrInqBegin.

Especifique um valor nulo para impedir que RpcNsGroupMbrInqNext retorne o parâmetro MemberName. Nesse caso, o aplicativo não chama a função RpcStringFree.

Valor de retorno

Valor	Significado
RPC_S_OK	A chamada foi bem-sucedida.
RPC_S_INVALID_NS_HANDLE	O identificador de nome-serviço é inválido.
RPC_S_NO_MORE_MEMBERS	Não há mais membros.
RPC_S_NAME_SERVICE_UNAVAILABLE	O serviço de nome não está disponível.

Observação Para obter uma lista de códigos de erro válidos, consulte RPC Return Values.

Observações

A função RpcNsGroupMbrInqNext retorna um membro do grupo RPC especificado pelo parâmetro GroupName em RpcNsGroupMbrInqBegin. Um aplicativo pode exibir todos os membros de um grupo RPC definido chamando repetidamente RpcNsGroupMbrInqNext. Quando todos os membros do grupo tiverem sido exibidos, essa função retornará um código de status RPC_S_NO_MORE_MEMBERS. Os membros retornados do grupo não são ordenados.

Em cada chamada para RpcNsGroupMbrInqNext que retorna um nome de membro, a biblioteca de tempo de execução RPC aloca memória para oMemberName retornado. O aplicativo é responsável por chamar RpcStringFree para cada cadeia de caracteres MemberName retornada. Depois de exibir os membros do grupo RPC, o aplicativo deve chamar RpcNsGroupMbrInqDone para liberar o contexto de investigação.

A ordem na qual os membros do grupo são retornados pode ser diferente para cada exibição de um grupo. Isso significa que a ordem na qual os membros do grupo são retornados a um aplicativo pode ser diferente cada vez que o aplicativo é executado.

Observação o Windows 2000 Active Directory dá suporte a essa função. Versões anteriores do Windows NT dão suporte apenas ao uso dessa função com o CDS (Serviço de Diretório de Células).

Nota

O cabeçalho rpcnsi.h define RpcNsGroupMbrInqNext como um alias que seleciona automaticamente a versão ANSI ou Unicode dessa função com base na definição da constante do pré-processador UNICODE. A combinação do uso do alias neutro de codificação com código que não é neutro em codificação pode levar a incompatibilidades que resultam em erros de compilação ou de runtime. Para obter mais informações, consulte Conventions for Function Prototypes.

Requisitos

Requisito	Valor
de cliente com suporte mínimo	Windows 2000 Professional [somente aplicativos da área de trabalho]
servidor com suporte mínimo	Windows 2000 Server [somente aplicativos da área de trabalho]
da Plataforma de Destino	Windows
cabeçalho	rpcnsi.h (inclua Rpc.h)
biblioteca	Rpcns4.lib
de DLL	Rpcns4.dll

Consulte também

RpcNsGroupMbrInqBegin

RpcNsGroupMbrInqDone

RpcStringFree

Compartilhar via