Função RpcMgmtInqIfIds (rpcdce.h)

  • Artigo

A função RpcMgmtInqIfIds retorna um vetor que contém os identificadores das interfaces oferecidas pelo servidor.

Sintaxe

RPC_STATUS RpcMgmtInqIfIds(
  RPC_BINDING_HANDLE Binding,
  RPC_IF_ID_VECTOR   **IfIdVector
);

Parâmetros

Binding

Para receber identificadores de interface sobre um aplicativo remoto, especifique um identificador de associação de servidor para esse aplicativo. Para receber informações de interface sobre seu próprio aplicativo, especifique um valor NULL.

IfIdVector

Retorna o endereço de um vetor de identificador de interface.

Valor retornado

Valor Significado
RPC_S_OK
 A chamada foi bem-sucedida.
RPC_S_INVALID_BINDING
 O identificador de associação era inválido.
RPC_S_WRONG_KIND_OF_BINDING
 Esse foi o tipo errado de associação para a operação.
 
Nota Para obter uma lista de códigos de erro válidos, consulte RPC Return Values.
 

Comentários

Um aplicativo chama a função RpcMgmtInqIfIds para obter um vetor de identificadores de interface sobre o servidor especificado da biblioteca de tempo de execução RPC.

A biblioteca de tempo de execução RPC aloca memória para o vetor do identificador de interface. O aplicativo é responsável por chamar a função RpcIfIdVectorFree para liberar a memória usada por esse vetor.

O servidor deve estar escutando chamadas de procedimento remoto para que essa função tenha êxito. Se o servidor não estiver escutando, a função falhará.

Requisitos

   
Cliente mínimo com suporte Windows 2000 Professional [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Windows 2000 Server [somente aplicativos da área de trabalho]
Plataforma de Destino Windows
Cabeçalho rpcdce.h (inclua Rpc.h)
Biblioteca Rpcrt4.lib
DLL Rpcrt4.dll

Confira também

RpcIfIdVectorFree