Interfaccia IBindCtx (objidl.h)

Articolo
08/25/2023

Fornisce l'accesso a un contesto di associazione, ovvero un oggetto che archivia informazioni su un'operazione di associazione di moniker specifica.

Ereditarietà

L'interfaccia IBindCtx eredita dall'interfaccia IUnknown . IBindCtx include anche questi tipi di membri:

Metodi

L'interfaccia IBindCtx include questi metodi.


IBindCtx::EnumObjectParam Recupera un puntatore a un'interfaccia che può essere utilizzata per enumerare le chiavi della tabella con chiave stringa del contesto di associazione di puntatori.
IBindCtx::GetBindOptions Recupera le opzioni di associazione archiviate in questo contesto di associazione.
IBindCtx::GetObjectParam Recupera un puntatore di interfaccia all'oggetto associato alla chiave specificata nella tabella con chiave di stringa del contesto di associazione di puntatori.
IBindCtx::GetRunningObjectTable Recupera un puntatore di interfaccia alla tabella degli oggetti in esecuzione (ROT) per il computer in cui è in esecuzione questo contesto di associazione.
IBindCtx::RegisterObjectBound Registra un oggetto con il contesto di associazione per assicurarsi che l'oggetto rimanga attivo fino al rilascio del contesto di associazione.
IBindCtx::RegisterObjectParam Associa un oggetto a una chiave stringa nella tabella con chiave con chiave stringa del contesto di associazione di puntatori.
IBindCtx::ReleaseBoundObjects Rilascia tutti i puntatori a tutti gli oggetti registrati in precedenza dalle chiamate a RegisterObjectBound.
IBindCtx::RevokeObjectBound Rimuove l'oggetto dal contesto di associazione, annullando una chiamata precedente a RegisterObjectBound.
IBindCtx::RevokeObjectParam Rimuove la chiave specificata e il puntatore associato dalla tabella con chiave stringa del contesto di associazione degli oggetti. La chiave deve essere stata inserita in precedenza nella tabella con una chiamata a RegisterObjectParam.
IBindCtx::SetBindOptions Imposta nuovi valori per i parametri di associazione archiviati nel contesto di associazione.

Commenti

Un contesto di associazione include le informazioni seguenti:

Struttura BIND_OPTS contenente un set di parametri che non cambiano durante l'operazione di associazione. Quando viene associato un moniker composito, ogni componente usa lo stesso contesto di associazione, quindi funge da meccanismo per passare gli stessi parametri a ogni componente di un moniker composito.
Set di puntatori agli oggetti attivati dall'operazione di associazione. Il contesto di associazione contiene puntatori a questi oggetti associati, mantenendoli caricati ed eliminando così le attivazioni ridondanti se gli oggetti sono nuovamente necessari durante le operazioni di associazione successive.
Puntatore alla tabella di oggetti in esecuzione (ROT) nello stesso computer del processo che ha avviato l'operazione di associazione. Le implementazioni moniker che devono accedere a ROT devono usare il metodo IBindCtx::GetRunningObjectTable anziché usare la funzione GetRunningObjectTable . Ciò consente miglioramenti futuri all'implementazione IBindCtx del sistema per modificare il comportamento di associazione.
Tabella di puntatori di interfaccia, ognuno associato a una chiave stringa. Questa funzionalità consente alle implementazioni del moniker di archiviare puntatori di interfaccia in una stringa nota in modo che possano essere recuperate successivamente dal contesto di associazione. Ad esempio, OLE definisce diverse chiavi stringa ("ExceededDeadline", "ConnectManually" e così via) che possono essere usate per archiviare un puntatore all'oggetto che ha causato un errore durante un'operazione di associazione.

Requisiti

Requisito	Valore
Client minimo supportato	Windows 2000 Professional [app desktop \| App UWP]
Server minimo supportato	Windows 2000 Server [app desktop \| App UWP]
Piattaforma di destinazione	Windows
Intestazione	objidl.h

Vedi anche

Share via