Função RpcMgmtEpEltInqNextA (rpcdce.h)

Artigo
11/20/2024

A função RpcMgmtEpEltInqNext retorna um elemento de um mapa de ponto de extremidade.

Sintaxe

RPC_STATUS RpcMgmtEpEltInqNextA(
  RPC_EP_INQ_HANDLE  InquiryContext,
  RPC_IF_ID          *IfId,
  RPC_BINDING_HANDLE *Binding,
  UUID               *ObjectUuid,
  RPC_CSTR           *Annotation
);

Parâmetros

InquiryContext

Especifica um contexto de investigação. O contexto de investigação é retornado de RpcMgmtEpEltInqBegin .

IfId

Retorna o identificador de interface do elemento de mapa de ponto de extremidade.

Binding

Opcional. Retorna o identificador de associação do elemento de mapa de ponto de extremidade.

ObjectUuid

Opcional. Retorna o objeto UUID do elemento de mapa de ponto de extremidade.

Annotation

Opcional. Retorna a cadeia de caracteres de anotação para o elemento de mapa de ponto de extremidade. Quando não há nenhuma cadeia de caracteres de anotação no elemento de mapa de ponto de extremidade, a cadeia de caracteres vazia ("") é retornada.

Valor de retorno

Valor	Significado
RPC_S_OK	A chamada foi bem-sucedida.

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

Observações

A função RpcMgmtEpEltInqNext retorna um elemento do mapa do ponto de extremidade. Os elementos selecionados dependem do contexto de investigação. Os critérios de seleção são determinados por InquiryType da função RpcMgmtEpEltInqBegin que retornou InquiryContext.

Um aplicativo pode exibir todos os elementos de mapa de ponto de extremidade selecionados chamando repetidamente RpcMgmtEpEltInqNext. Quando todos os elementos tiverem sido exibidos, essa função retornará um status RPC_X_NO_MORE_ENTRIES. Os elementos retornados não são ordenados.

Quando os respectivos argumentos não são NULL, a biblioteca de funções em tempo de execução RPC aloca memória para de Associação e Anotação em cada chamada para essa função. O aplicativo é responsável por chamar RpcBindingFree para cada de Associação retornado e RpcStringFree para cadade Anotação retornado.

Depois de exibir os elementos do mapa de ponto de extremidade, o aplicativo deve chamar RpcMgmtEpEltInqDone para excluir o contexto de investigação.

Nota

O cabeçalho rpcdce.h define RpcMgmtEpEltInqNext 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	rpcdce.h (inclua Rpc.h)
biblioteca	Rpcrt4.lib
de DLL	Rpcrt4.dll

Consulte também

RpcEpRegister

RpcMgmtEpEltInqBegin

RpcMgmtEpEltInqDone

Compartilhar via