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 |