Metodo IOleObject::GetMoniker (oleidl.h)

Articolo
03/05/2024

Recupera il moniker di un oggetto incorporato, che il chiamante può usare per collegare l'oggetto.

Sintassi

HRESULT GetMoniker(
  [in]  DWORD    dwAssign,
  [in]  DWORD    dwWhichMoniker,
  [out] IMoniker **ppmk
);

Parametri

[in] dwAssign

Determina la modalità con cui il moniker viene assegnato all'oggetto. A seconda del valore di dwAssign, IOleObject::GetMoniker esegue una delle operazioni seguenti:

Ottiene un moniker solo se ne è già stato assegnato uno.
Forza l'assegnazione di un moniker, se necessario, per soddisfare la chiamata.
Ottiene un moniker temporaneo.

I valori per dwAssign vengono specificati nell'enumerazione OLEGETMONIKER.

Nota Non è possibile passare OLEGETMONIKER_UNASSIGN quando si chiama IOleObject::GetMoniker. Questo valore è valido solo quando si chiama IOleObject::GetMoniker.

[in] dwWhichMoniker

Specifica il form del moniker da richiedere. I valori possibili vengono acquisiti dall'enumerazione OLEWHICHMK.

[out] ppmk

Indirizzo della variabile puntatore IMoniker che riceve il puntatore dell'interfaccia al moniker dell'oggetto. Se si verifica un errore, ppmk deve essere impostato su NULL. Ogni volta che un oggetto riceve una chiamata a IOleObject::GetMoniker, deve aumentare il conteggio dei riferimenti su ppmk. È responsabilità del chiamante chiamare Release quando viene fatto con ppmk.

Valore restituito

Questo metodo restituisce S_OK se l'operazione ha esito positivo.

Commenti

Il metodo IOleObject::GetMoniker restituisce il moniker di un oggetto. Come IOleObject::SetMoniker, questo metodo è importante solo nel contesto di gestione dei collegamenti agli oggetti incorporati e anche in questo caso è facoltativo. Un potenziale client di collegamento che richiede il moniker di un oggetto da associare all'oggetto può chiamare questo metodo per ottenere tale moniker. L'implementazione predefinita di IOleObject::GetMoniker chiama IOleClientSite::GetMoniker, restituendo E_UNEXPECTED se l'oggetto non è in esecuzione o non ha un puntatore valido a un sito client.

Requisiti

Requisito	Valore
Client minimo supportato	Windows 2000 Professional [solo app desktop]
Server minimo supportato	Windows 2000 Server [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	oleidl.h