Função RpcNsProfileEltInqNextA (rpcnsi.h)

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

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 nome-serviço 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 Annotation . Nesse caso, o aplicativo não precisa chamar a função RpcStringFree .

Valor retornado

Comentários

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 RPC_S_NO_MORE_ELEMENTS status. 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 consulta.

Requisitos

Confira também

RpcNsProfileEltInqBegin

RpcNsProfileEltInqDone

RpcStringFree