Funzione RtmGetEntityMethods (rtmv2.h)
La funzione RtmGetEntityMethods esegue una query sul client specificato per determinare quali metodi sono disponibili per un altro client da richiamare.
Sintassi
DWORD RtmGetEntityMethods(
[in] RTM_ENTITY_HANDLE RtmRegHandle,
[in] RTM_ENTITY_HANDLE EntityHandle,
[in, out] PUINT NumMethods,
[out] PRTM_ENTITY_EXPORT_METHOD ExptMethods
);
Parametri
[in] RtmRegHandle
Handle per il client ottenuto da una chiamata precedente a RtmRegisterEntity.
[in] EntityHandle
Handle per il client per il quale ottenere i metodi.
[in, out] NumMethods
In input , NumMethods specifica un puntatore valido a un valore UINT . Specificare zero per restituire il numero di metodi disponibili per l'esportazione.
Nell'output , NumMethods riceve il numero di metodi esportati dal client.
[out] ExptMethods
Riceve un puntatore a una struttura RTM_ENTITY_EXPORT_METHOD che contiene il set di identificatori di metodo richiesti dal client chiamante.
Valore restituito
Se la funzione ha esito positivo, il valore restituito viene NO_ERROR.
Se la funzione ha esito negativo, il valore restituito è uno dei codici di errore seguenti.
| Valore | Significato |
|---|---|
|
Il buffer fornito non è sufficientemente grande da contenere tutte le informazioni richieste. |
Commenti
Non chiamare direttamente il metodo di un altro client, usare sempre RtmInvokeMethod. Gestione tabelle di routing esegue il controllo degli errori quando si usa RtmInvokeMethod per assicurarsi che il client non sia già registrato o non registrato.
Se viene restituito ERROR_INSUFFICIENT_BUFFER, potrebbero essere presenti alcuni dati in ExptMethods; NumMethods specifica il numero di metodi effettivamente adatti al buffer.
Quando l'handle di entità non è più necessario, rilasciarlo chiamando RtmReleaseEntities.
Per il codice di esempio che usa questa funzione, vedere Ottenere e chiamare i metodi esportati per un client.
Requisiti
| Requisito | Valore |
|---|---|
| Client minimo supportato | Nessuno supportato |
| Server minimo supportato | Windows 2000 Server [solo app desktop] |
| Piattaforma di destinazione | Windows |
| Intestazione | rtmv2.h |
| Libreria | Rtm.lib |
| DLL | Rtm.dll |