Metodo IBindCtx::GetObjectParam (objidl.h)

Articolo
08/25/2023

Recupera un puntatore dell'interfaccia all'oggetto associato alla chiave specificata nella tabella con chiave stringa del contesto di associazione dei puntatori.

Sintassi

HRESULT GetObjectParam(
  [in]  LPOLESTR pszKey,
  [out] IUnknown **ppunk
);

Parametri

[in] pszKey

Chiave stringa di contesto di associazione da cercare. Il confronto tra stringhe chiave è distinzione tra maiuscole e minuscole.

[out] ppunk

Indirizzo di una variabile puntatore IUnknown* che riceve il puntatore dell'interfaccia all'oggetto associato a pszKey. In caso di esito positivo, l'implementazione chiama AddRef in *ppunk. È responsabilità del chiamante chiamare Release. Se si verifica un errore, l'implementazione imposta *ppunk su NULL.

Valore restituito

Se il metodo ha esito positivo, il valore restituito è S_OK. In caso contrario, è E_FAIL.

Commenti

Un contesto di associazione gestisce una tabella di puntatori di interfaccia, ognuno associato a una chiave stringa. Ciò consente la comunicazione tra un'implementazione moniker e il chiamante che ha avviato l'operazione di associazione. Una parte può archiviare un puntatore dell'interfaccia in una stringa nota a entrambe le parti in modo che l'altra parte possa recuperarla successivamente dal contesto di associazione.

Il puntatore che questo metodo recupera deve essere stato inserito in precedenza nella tabella usando il metodo IBindCtx::RegisterObjectParam .

Note ai chiamanti

Gli oggetti che usano moniker per individuare altri oggetti possono chiamare questo metodo quando un'operazione di associazione non riesce a ottenere informazioni specifiche sull'errore che si è verificato. A seconda dell'errore, potrebbe essere possibile correggere la situazione e ripetere l'operazione di associazione. Per altre informazioni, vedere IBindCtx::RegisterObjectParam .

Le implementazioni di Moniker possono chiamare questo metodo per gestire situazioni in cui un chiamante avvia un'operazione di associazione e richiede informazioni specifiche. Per convenzione, l'implementer deve usare i nomi delle chiavi che iniziano con il formato stringa della classe CLSID di una classe moniker. Vedere la funzione StringFromCLSID .

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

Ibindctx

Condividi tramite