Nota
L'accesso a questa pagina richiede l'autorizzazione. È possibile provare ad accedere o modificare le directory.
L'accesso a questa pagina richiede l'autorizzazione. È possibile provare a modificare le directory.
[L'uso di questa funzione è sconsigliato. Potrebbe essere modificata o non disponibile nelle versioni successive di Windows.]
La funzione MAPIDetails visualizza una finestra di dialogo contenente i dettagli di una voce di elenco indirizzi selezionata.
Sintassi
MAPIDETAILS Mapidetails;
ULONG Mapidetails(
[in] LHANDLE lhSession,
[in] ULONG_PTR ulUIParam,
[in] lpMapiRecipDesc lpRecip,
[in] FLAGS flFlags,
ULONG ulReserved
)
{...}
Parametri
[in] lhSession
Handle di sessione che rappresenta una sessione MAPI semplice o zero. Se il valore del parametro lhSession è zero, MAPI accede all'utente e crea una sessione esistente solo per la durata della chiamata. Questa sessione temporanea può essere una sessione condivisa esistente o una nuova. Se sono necessarie informazioni aggiuntive dall'utente per completare correttamente l'accesso, viene visualizzata una finestra di dialogo.
[in] ulUIParam
Handle finestra padre o zero, che indica che se viene visualizzata una finestra di dialogo, è modale dell'applicazione. Se il parametro ulUIParam contiene un handle di finestra padre, è di tipo HWND (cast a un ULONG_PTR). Se non viene visualizzata alcuna finestra di dialogo durante la chiamata, ulUIParam viene ignorato.
[in] lpRecip
Puntatore al destinatario per cui visualizzare i dettagli. MAPIDetails ignora tutti i membri di questa struttura MapiRecipDesc ad eccezione dei membri ulEIDSize e lpEntryID . Se il valore di ulEIDSize è diverso da zero, MAPIDetails risolve la voce del destinatario. Se il valore di ulEIDSize è zero, MAPIDetails restituisce il valore MAPI_E_AMBIGUOUS_RECIP.
[in] flFlags
Maschera di bit dei flag di opzione. È possibile impostare i flag seguenti.
ulReserved
Riservati; deve essere zero.
Valore restituito
Questa funzione restituisce uno dei valori seguenti.
| Codice restituito | Descrizione |
|---|---|
|
Impossibile visualizzare la finestra di dialogo perché il membro ulEIDSize della struttura a cui punta il parametro lpRecips è zero. |
|
Si sono verificati uno o più errori non specificati. Non è stata visualizzata alcuna finestra di dialogo. |
|
Memoria insufficiente per continuare. Non è stata visualizzata alcuna finestra di dialogo. |
|
Il destinatario specificato nel parametro lpRecip è sconosciuto o il destinatario ha un valore ulEIDSize non valido. Non è stata visualizzata alcuna finestra di dialogo. |
|
Non è stato eseguito l'accesso predefinito e l'utente non è riuscito ad accedere correttamente quando è stata visualizzata la finestra di dialogo di accesso. Non è stata visualizzata alcuna finestra di dialogo. |
|
L'operazione non è supportata dal sistema di messaggistica sottostante. |
|
L'utente ha annullato la finestra di dialogo di accesso o la finestra di dialogo dei dettagli. |
|
La chiamata è riuscita e la finestra di dialogo dei dettagli è stata visualizzata. |
Commenti
La funzione MAPIDetails presenta una finestra di dialogo che mostra i dettagli di una voce di elenco indirizzi specifica. Il nome visualizzato e l'indirizzo sono gli attributi minimi visualizzati nella finestra di dialogo; è possibile visualizzare ulteriori informazioni, a seconda del provider della rubrica. Non è possibile eliminare la finestra di dialogo dei dettagli, ma il chiamante può richiedere che sia di sola lettura o modificabile.
I dettagli possono essere visualizzati solo per le voci dell'elenco di indirizzi risolte. Una voce viene risolta se il valore del membro ulEIDSize della struttura MapiRecipDesc è diverso da zero. Le voci vengono risolte quando vengono restituite dalle funzioni MAPIAddress o MAPIResolveName e come risultato sono destinatari della posta in lettura.
Requisiti
| Piattaforma di destinazione | Windows |
| Intestazione | mapi.h |