Función RtmGetEntityMethods (rtmv2.h)

La función RtmGetEntityMethods consulta al cliente especificado para determinar qué métodos están disponibles para que otro cliente invoque.

Sintaxis

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

Identificador del cliente obtenido de una llamada anterior a RtmRegisterEntity.

[in] EntityHandle

Controlar al cliente para el que se van a obtener métodos.

[in, out] NumMethods

En la entrada, NumMethods especifica un puntero válido a un valor UINT . Especifique cero para devolver el número de métodos disponibles para exportarse.

En la salida, NumMethods recibe el número de métodos exportados por el cliente.

[out] ExptMethods

Recibe un puntero a una estructura de RTM_ENTITY_EXPORT_METHOD que contiene el conjunto de identificadores de método solicitados por el cliente que realiza la llamada.

Valor devuelto

Si la función se realiza correctamente, el valor devuelto es NO_ERROR.

Si se produce un error en la función, el valor devuelto es uno de los siguientes códigos de error.

Comentarios

No llame directamente al método de otro cliente, use siempre RtmInvokeMethod. El administrador de tablas de enrutamiento realiza la comprobación de errores al usar RtmInvokeMethod para asegurarse de que el cliente no está anulando el registro o que ya no está registrado.

Si se devuelve ERROR_INSUFFICIENT_BUFFER, puede haber algunos datos en ExptMethods; NumMethods especifica cuántos métodos caben realmente en el búfer.

Cuando el identificador de entidad ya no sea necesario, ábralo llamando a RtmReleaseEntities.

Para obtener código de ejemplo con esta función, vea Obtener y llamar a los métodos exportados para un cliente.

Requisitos

Consulte también

RtmBlockMethods

RtmInvokeMethod