Compartilhar via

Função RtmGetEntityMethods (rtmv2.h)

  • Artigo

A função RtmGetEntityMethods consulta o cliente especificado para determinar quais métodos estão disponíveis para outro cliente invocar.

Sintaxe

DWORD RtmGetEntityMethods(
  [in]      RTM_ENTITY_HANDLE         RtmRegHandle,
  [in]      RTM_ENTITY_HANDLE         EntityHandle,
  [in, out] PUINT                     NumMethods,
  [out]     PRTM_ENTITY_EXPORT_METHOD ExptMethods
);

Parâmetros

[in] RtmRegHandle

Manipule para o cliente obtido de uma chamada anterior para RtmRegisterEntity.

[in] EntityHandle

Manipule para o cliente para o qual obter métodos.

[in, out] NumMethods

Na entrada, NumMethods especifica um ponteiro válido para um valor UINT . Especifique zero para retornar o número de métodos disponíveis para exportação.

Na saída, NumMethods recebe o número de métodos exportados pelo cliente.

[out] ExptMethods

Recebe um ponteiro para uma estrutura RTM_ENTITY_EXPORT_METHOD que contém o conjunto de identificadores de método solicitados pelo cliente de chamada.

Retornar valor

Se a função for bem-sucedida, o valor retornado será NO_ERROR.

Se a função falhar, o valor retornado será um dos seguintes códigos de erro.

Valor Significado
ERROR_INSUFFICIENT_BUFFER
 O buffer fornecido não é grande o suficiente para conter todas as informações solicitadas.

Comentários

Não chame o método de outro cliente diretamente, sempre use RtmInvokeMethod. O gerenciador de tabelas de roteamento executa a verificação de erros ao usar RtmInvokeMethod para garantir que o cliente não esteja cancelando o registro ou já não registrado.

Se ERROR_INSUFFICIENT_BUFFER for retornado, poderá haver alguns dados em ExptMethods; NumMethods especifica quantos métodos realmente se encaixam no buffer.

Quando o identificador de entidade não for mais necessário, libere-o chamando RtmReleaseEntities.

Para obter o código de exemplo que usa essa função, consulte Obter e chamar os métodos exportados para um cliente.

Requisitos

Requisito Valor
Cliente mínimo com suporte Nenhum compatível
Servidor mínimo com suporte Windows 2000 Server [somente aplicativos da área de trabalho]
Plataforma de Destino Windows
Cabeçalho rtmv2.h
Biblioteca Rtm.lib
DLL Rtm.dll

Confira também

RtmBlockMethods

RtmInvokeMethod