Metodo IMoniker::IsEqual (objidl.h)

Determina se questo moniker è identico al moniker specificato.

Sintassi

HRESULT IsEqual(
  [in] IMoniker *pmkOtherMoniker
);

Parametri

[in] pmkOtherMoniker

Puntatore all'interfaccia IMoniker nel moniker da usare per il confronto con questo (quello da cui viene chiamato questo metodo).

Valore restituito

Questo metodo restituisce S_OK per indicare che i due moniker sono identici e S_FALSE in caso contrario.

Commenti

Implementazioni precedenti della tabella degli oggetti in esecuzione (ROT) denominata questo metodo. L'implementazione corrente di ROT usa invece l'interfaccia IROTData .

Note ai chiamanti

Chiamare questo metodo per determinare se due moniker sono identici. La forma ridotta di un moniker è considerata diversa dalla forma non generata. È necessario chiamare il metodo IMoniker::Reduce prima di chiamare IsEqual, perché un moniker ridotto è nel formato più specifico. IsEqual può restituire S_FALSE su due moniker prima di essere ridotti e S_OK dopo la riduzione.

Note per gli implementatori

L'implementazione non deve ridurre il moniker corrente prima di eseguire il confronto. È responsabilità del chiamante chiamare IMoniker::Reduce per confrontare i moniker ridotti.

Due moniker che confrontano come uguali devono eseguire l'hash allo stesso valore usando IMoniker::Hash.

Note specifiche dell'implementazione

Implementazione	Note
Anti-moniker	Questo metodo restituisce S_OK se entrambi sono anti-moniker; in caso contrario, restituisce S_FALSE.
Moniker classe	Questo metodo restituisce S_OK se pmkOther è un moniker di classe costruito con le stesse informazioni CLSID. In caso contrario, il metodo restituisce S_FALSE. Può restituire E_INVALIDARG se pmkOther è un puntatore non valido.
Moniker file	Questo metodo restituisce S_OK se *pmkOther è un moniker di file e i percorsi per entrambi i moniker sono identici (usando un confronto senza distinzione tra maiuscole e minuscole). In caso contrario, il metodo restituisce S_FALSE.
Moniker composito generico	Questo metodo restituisce S_OK se i componenti di entrambi i moniker sono uguali rispetto all'ordine a sinistra a destra.
Moniker elemento	Questo metodo restituisce S_OK se entrambi i moniker sono moniker di elementi e i relativi nomi di visualizzazione sono identici (usando un confronto senza distinzione tra maiuscole e minuscole); in caso contrario, il metodo restituisce S_FALSE.
Moniker OBJREF	Questo metodo restituisce S_OK se *pmkOther è un moniker OBJREF e i percorsi per entrambi i moniker sono identici (usando un confronto senza distinzione tra maiuscole e minuscole). In caso contrario, il metodo restituisce S_FALSE.
Moniker puntatore	Questo metodo restituisce S_OK solo se entrambi sono moniker puntatori e puntatori dell'interfaccia che eseguono il wrapping sono identici.
Moniker URL	Restituisce S_FALSE se l'altro moniker (pmkOtherMoniker) non è un moniker URL, che controlla l'uso di IPersist::GetClassID per verificare se CLSID è CLSID_URLMoniker. Se l'altro moniker è un moniker URL, confronta i nomi visualizzati dei moniker per l'uguaglianza, restituendo S_OK se sono identici o S_FALSE in caso contrario.

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

Vedi anche

Imoniker

IROTData