IAddrBook::GetSearchPath
Hace referencia a: Outlook 2013 | Outlook 2016
Devuelve una lista ordenada de identificadores de entrada de los contenedores que se incluirán en el proceso de resolución de nombres iniciado por el método IAddrBook::ResolveName .
HRESULT GetSearchPath(
ULONG ulFlags,
LPSRowSet FAR * lppSearchPath
);
Parameters
ulFlags
[in] Máscara de bits de marcas que controla el tipo de las cadenas devueltas en la ruta de acceso de búsqueda. Se puede establecer la marca siguiente:
MAPI_UNICODE
Las cadenas devueltas están en formato Unicode. Si no se establece la marca de MAPI_UNICODE, las cadenas están en formato ANSI.
lppSearchPath
[out] Puntero a un puntero a una lista ordenada de identificadores de entrada de contenedor. GetSearchPath almacena la lista ordenada en una estructura SRowSet . Si no hay contenedores en la jerarquía de la libreta de direcciones, se devuelve cero en la estructura SRowSet .
Valor devuelto
S_OK
La ruta de acceso de búsqueda se recuperó correctamente.
Comentarios
Los clientes y proveedores de servicios llaman al método GetSearchPath para obtener la ruta de acceso de búsqueda que se usa para resolver nombres con el método ResolveName . Normalmente, los clientes llaman al método IAddrBook::SetSearchPath para establecer una ruta de acceso de búsqueda de contenedor en el perfil antes de llamar a GetSearchPath para recuperarla. Sin embargo, llamar a SetSearchPath es opcional.
Si nunca se ha llamado a SetSearchPath , GetSearchPath crea una ruta de acceso trabajando a través de las tablas de jerarquía de la libreta de direcciones. La ruta de acceso de búsqueda predeterminada establecida por GetSearchPath consta de los siguientes contenedores en el orden siguiente:
El primer contenedor con permiso de lectura y escritura, normalmente la libreta de direcciones personal (PAB).
Cada contenedor que tiene su propiedad PR_DISPLAY_TYPE (PidTagDisplayType) establecida en DT_GLOBAL. Esta configuración indica que el contenedor contiene destinatarios.
El contenedor designado como predeterminado, si no hay contenedores que tengan establecida la marca de DT_GLOBAL en su propiedad PR_DISPLAY_TYPE y el contenedor predeterminado difiere del primer contenedor con permiso de lectura y escritura.
Si se ha llamado a SetSearchPath , GetSearchPath crea una ruta de acceso mediante los contenedores de la libreta de direcciones que se han almacenado en el perfil. GetSearchPath valida esta ruta de acceso antes de devolverla al autor de la llamada.
Después de la primera llamada a SetSearchPath, se deben usar llamadas posteriores a SetSearchPath para modificar la ruta de acceso de búsqueda devuelta por GetSearchPath. En otras palabras, el cliente o proveedor que realiza la llamada no recibe la ruta de acceso de búsqueda predeterminada después de la primera llamada a SetSearchPath.