Função RpcNsProfileEltInqNextA (rpcnsi.h)

A função RpcNsProfileEltInqNext retorna um elemento de cada vez de um perfil.

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

 

Sintaxe

RPC_STATUS RpcNsProfileEltInqNextA(
  RPC_NS_HANDLE InquiryContext,
  RPC_IF_ID     *IfId,
  RPC_CSTR      *MemberName,
  unsigned long *Priority,
  RPC_CSTR      *Annotation
);

Parâmetros

InquiryContext

Identificador de serviço de nome retornado da função RpcNsProfileEltInqBegin.

IfId

Retorna um ponteiro para a identificação da interface do elemento de perfil.

MemberName

Retorna um ponteiro para um ponteiro para o nome do membro do elemento de perfil. A sintaxe do nome retornado foi especificada pelo parâmetro MemberNameSyntax na função RpcNsProfileEltInqBegin.

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

Priority

Retorna um ponteiro para a prioridade do elemento de perfil.

Annotation

Retorna um ponteiro para um ponteiro para a cadeia de caracteres de anotação do elemento de perfil. Se não houver nenhuma cadeia de caracteres de anotação no elemento de perfil, a cadeia de caracteres \0 será retornada.

Especifique um valor nulo para impedir que RpcNsProfileEltInqNext retorne o parâmetro de Anotação . Nesse caso, o aplicativo não precisa chamar a função RpcStringFree.

Valor de retorno

Valor	Significado
RPC_S_OK	A chamada foi bem-sucedida.
RPC_S_INCOMPLETE_NAME	O nome está incompleto.
RPC_S_NAME_SERVICE_UNAVAILABLE	O serviço de nome não está disponível.
RPC_S_NO_MORE_ELEMENTS	Não há mais elementos.

 

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

 

Observações

A função RpcNsProfileEltInqNext retorna um elemento do perfil especificado pelo parâmetro ProfileName em RpcNsProfileEltInqBegin. Independentemente do valor de InquiryType em RpcNsProfileEltInqBegin, RpcNsProfileEltInqNext retorna todos os componentes (identificação da interface, nome do membro, prioridade, cadeia de caracteres de anotação) de um elemento de perfil.

Um aplicativo pode exibir todas as entradas de perfil selecionadas chamando repetidamente a função RpcNsProfileEltInqNext. Quando todos os elementos tiverem sido exibidos, essa função retornará um código de status RPC_S_NO_MORE_ELEMENTS. Os elementos retornados não são ordenados.

Em cada chamada para RpcNsProfileEltInqNext que retorna um elemento de perfil, a biblioteca de tempo de execução RPC aloca memória para o nome do membro retornado e a cadeia de caracteres de anotação. O aplicativo é responsável por chamar a função RpcStringFree para cada nome de membro retornado e cadeia de caracteres de anotação. Depois de exibir os elementos do perfil, o aplicativo deve chamar RpcNsProfileEltInqDone para liberar o contexto de investigação.

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 RpcNsProfileEltInqNext 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

RpcNsProfileEltInqBegin

RpcNsProfileEltInqDone

RpcStringFree