Funzione MonikerRelativePathTo (objbase.h)

Articolo
02/29/2024

Fornisce un moniker che, se composto alla fine del primo moniker specificato (o uno con una struttura simile), restituisce il secondo moniker specificato.

Questa funzione è destinata all'uso solo da implementazioni IMoniker::RelativePathTo .

Sintassi

HRESULT MonikerRelativePathTo(
  [in]  LPMONIKER pmkSrc,
  [in]  LPMONIKER pmkDest,
  [out] LPMONIKER *ppmkRelPath,
  [in]  BOOL      dwReserved
);

Parametri

[in] pmkSrc

Puntatore all'interfaccia IMoniker nel moniker che, quando viene composto con il moniker relativo da creare, produce pmkDest. Questo moniker identifica l'origine del moniker relativo da creare.

[in] pmkDest

Puntatore all'interfaccia IMoniker nel moniker da esprimere in relazione a pmkSrc. Questo moniker identifica la destinazione del moniker relativo da creare.

[out] ppmkRelPath

Indirizzo di una variabile puntatore IMoniker* che riceve il puntatore dell'interfaccia al nuovo moniker relativo. In caso di esito positivo, la funzione ha chiamato AddRef nel moniker e il chiamante è responsabile della chiamata a Release. Se si verifica un errore, il valore del puntatore dell'interfaccia è NULL.

[in] dwReserved

Questo parametro è riservato e deve essere diverso da zero.

Valore restituito

Questa funzione può restituire i valori restituiti standard E_INVALIDARG, E_OUTOFMEMORY e E_UNEXPECTED, nonché i valori seguenti.

Codice restituito	Descrizione
S_OK	È stato restituito un percorso relativo significativo.
MK_S_HIM	L'unica forma del percorso relativo è l'altro moniker.
MK_E_NOTBINDABLE	Il parametro pmkSrc è un moniker relativo, ad esempio un moniker dell'elemento e deve essere composto con il moniker del contenitore prima che sia possibile determinare un percorso relativo.

Commenti

L'implementazione di IMoniker::RelativePathTo deve prima verificare se l'altro moniker è di un tipo riconosciuto e gestito in modo speciale. In caso contrario, è necessario chiamare MonikerRelativePathTo, passandosi come pmkThis e l'altro moniker come pmkOther. MonikerRelativePathTo gestisce correttamente i casi in cui entrambi i moniker sono un composito generico.

È consigliabile chiamare questa funzione solo se pmkSrc e pmkDest sono entrambi moniker assoluti, dove un moniker assoluto è un moniker di file o un composito generico il cui componente più sinistro è un moniker di file e dove il moniker del file rappresenta un percorso assoluto. Non chiamare questa funzione sui moniker relativi.

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	objbase.h
Libreria	Ole32.lib
DLL	Ole32.dll

Vedi anche

IMoniker::RelativePathTo

Condividi tramite