IAddrBook::GetDefaultDir
Hace referencia a: Outlook 2013 | Outlook 2016
Devuelve el identificador de entrada del contenedor de libreta de direcciones inicial.
HRESULT GetDefaultDir(
ULONG FAR * lpcbEntryID,
LPENTRYID FAR * lppEntryID
);
Parameters
lpcbEntryID
[out] Puntero al recuento de bytes en el identificador de entrada al que apunta el parámetro lppEntryID .
lppEntryID
[out] Puntero a un puntero al identificador de entrada del contenedor predeterminado.
Valor devuelto
S_OK
El identificador de entrada del contenedor predeterminado se devolvió correctamente.
Comentarios
Las aplicaciones cliente y los proveedores de servicios llaman al método GetDefaultDir para recuperar el identificador de entrada del contenedor de libreta de direcciones predeterminado. El contenedor predeterminado es lo que el usuario ve en la libreta de direcciones cuando se abre la libreta de direcciones por primera vez. Si no se ha establecido un contenedor predeterminado mediante una llamada al método IAddrBook::SetDefaultDir , MAPI asigna como contenedor predeterminado el primer contenedor con nombres que no son la libreta de direcciones personal (PAB). Si no se encuentra este tipo de contenedor, el PAB se convierte en el contenedor predeterminado.
Para establecer el directorio predeterminado, un cliente o proveedor llama al método SetDefaultDir . Los clientes y proveedores no tienen que llamar al método IMAPIProp::SaveChanges ; dado que los cambios en la libreta de direcciones no se realizan, los cambios se convierten inmediatamente en permanentes.
Referencia de MFCMAPI
Para obtener un ejemplo de código de MFCMAPI, vea la siguiente tabla.
| Archivo | Función | Comment |
|---|---|---|
| MainDlg.cpp |
CMainDlg::OnOpenDefaultDir |
MFCMAPI usa el método GetDefaultDir para obtener el identificador del contenedor de libreta de direcciones predeterminado. |