Metodo IMoniker::RelativePathTo (objidl.h)
Crea un moniker relativo tra questo moniker e il moniker specificato.
Sintassi
HRESULT RelativePathTo(
[in] IMoniker *pmkOther,
[out] IMoniker **ppmkRelPath
);
Parametri
[in] pmkOther
Puntatore all'interfaccia IMoniker nel moniker in cui deve essere eseguito un percorso relativo.
[out] ppmkRelPath
Puntatore a una variabile puntatore IMoniker che riceve il puntatore dell'interfaccia al moniker relativo. In caso di esito positivo, l'implementazione deve chiamare AddRef sul nuovo moniker; è responsabilità del chiamante chiamare Release. Se si verifica un errore, l'implementazione imposta *ppmkRelPath su NULL.
Valore restituito
Questo metodo può restituire i valori restituiti standard E_OUTOFMEMORY e E_UNEXPECTED, nonché i valori seguenti.
| Codice restituito | Descrizione |
|---|---|
|
Metodo completato correttamente. |
|
Nessun prefisso comune è condiviso dai due moniker e il moniker restituito in ppmkRelPath è pmkOther. |
|
Questo moniker è un moniker relativo, ad esempio un moniker di elemento. Questo moniker deve essere composto con il moniker del relativo contenitore prima di poter determinare un percorso relativo. |
Commenti
Un moniker relativo è analogo a un percorso relativo ,ad esempio ".. \backup"). Si supponga, ad esempio, di avere un moniker che rappresenta il percorso "c:\projects\secret\art\pict1.bmp" e un altro moniker che rappresenta il percorso "c:\projects\secret\docs\chap1.txt". Chiamando RelativePathTo sul primo moniker, passando il secondo come parametro pmkOther , creerebbe un moniker relativo che rappresenta il percorso ".. \docs\chap1.txt".
Note ai chiamanti
I client moniker in genere non devono chiamare RelativePathTo. Questo metodo viene chiamato principalmente dal gestore predefinito per gli oggetti collegati. Gli oggetti collegati contengono sia un moniker assoluto che un moniker relativo per identificare l'origine del collegamento. Ciò consente il rilevamento dei collegamenti se l'utente sposta un albero di directory contenente sia il contenitore che i file di origine. Il gestore predefinito chiama questo metodo per creare un moniker relativo dal documento contenitore all'origine del collegamento. Ovvero chiama RelativePathTo sul moniker che identifica il documento contenitore, passando il moniker che identifica l'origine del collegamento come parametro pmkOther .Se si chiama RelativePathTo, chiamarlo solo su moniker assoluti, ad esempio un moniker di file o un moniker composito il cui componente più a sinistra è un moniker di file, dove il moniker del file rappresenta un percorso assoluto. Non chiamare questo metodo sui moniker relativi.
Note per gli implementatori
L'implementazione di RelativePathTo deve innanzitutto determinare se pmkOther è un moniker di una classe riconosciuta e per cui è possibile fornire una gestione speciale, ad esempio se è della stessa classe di questo moniker. In tal caso, l'implementazione deve determinare il percorso relativo. In caso contrario, deve passare entrambi i moniker in una chiamata alla funzione MonikerRelativePathTo , che gestisce correttamente il case generico.Il primo passaggio per determinare un percorso relativo consiste nel determinare il prefisso comune di questo moniker e pmkOther. Il passaggio successivo consiste nell'suddividere questo moniker e pmkOther in due parti, ad esempio (P, myTail) e (P, otherTail) rispettivamente, dove P è il prefisso comune. Il percorso relativo corretto è quindi l'inverso di myTail composto con otherTail:
Comp( Inv( myTail ), otherTail )
dove Comp() rappresenta l'operazione di composizione e Inv() rappresenta l'operazione inversa.
Per determinati tipi di moniker, non è possibile usare il metodo IMoniker::Inverse per costruire l'inverso di myTail. Ad esempio, un moniker di file restituisce un anti-moniker come inverso, mentre il relativo metodo RelativePathTo deve usare uno o più moniker di file che rappresentano il percorso ".." per costruire l'inverso di myTail.
Note specifiche dell'implementazione
| Implementazione | Note |
|---|---|
| Anti-moniker | Questo metodo restituisce MK_S_HIM e imposta *ppmkRelPath sull'altro moniker. |
| Moniker di classe | Questo metodo restituisce il risultato della chiamata a MonikerRelativePathTo con pmkSrc uguale a questo moniker, pmkOther, ppmkRelPath e TRUE come dwReserved. |
| Moniker file | Questo metodo calcola un moniker che, quando composto a destra di questo moniker, restituisce l'altro moniker. Ad esempio, se il percorso di questo moniker è "C:\work\docs\report.doc" e se l'altro moniker è "C:\work\art\picture.bmp", il percorso del moniker calcolato sarà ".. \.. \art\picture.bmp". |
| Moniker composito generico | Questo metodo trova il prefisso comune dei due moniker e crea due moniker costituiti dal resto quando viene rimosso il prefisso comune. Crea quindi l'inverso per il resto di questo moniker e compone il resto dell'altro moniker a destra di esso. |
| Moniker elemento | Questo metodo restituisce MK_E_NOTBINDABLE e imposta *ppmkRelPath su NULL. |
| Moniker OBJREF | Questo metodo restituisce E_NOTIMPL. |
| Moniker puntatore | Questo metodo restituisce E_NOTIMPL. |
| Moniker URL | Questo metodo restituisce E_NOTIMPL. |
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 | objidl.h |