HrComposeMsgID

Hace referencia a: Outlook 2013 | Outlook 2016

Crea una cadena ASCII que representa un identificador de entrada compuesto para un objeto, normalmente un mensaje en un almacén de mensajes.

HrComposeMsgID(
  LPMAPISESSION psession,
  ULONG cbStoreRecordKey,
  LPBYTE pStoreRecordKey,
  ULONG cbMsgEID,
  LPENTRYID pMsgEID,
  LPSTR FAR * pszMsgID
);

Parameters

psession

[in] Puntero a la sesión en uso por la aplicación cliente.

cbStoreRecordKey

[in] Tamaño, en bytes, de la clave de registro del almacén de mensajes que contiene el mensaje u otro objeto. Si se pasa cero en el parámetro cbStoreRecordKey , el parámetro pszMsgID apunta a una copia del identificador de entrada convertido en texto.

pStoreRecordKey

[in] Puntero a la clave de registro del almacén de mensajes que contiene el mensaje u otro objeto.

cbMsgEID

[in] Tamaño, en bytes, del identificador de entrada del mensaje u otro objeto.

pMsgEID

[in] Puntero al identificador de entrada del objeto.

pszMsgID

[out] Puntero a la cadena ASCII devuelta. Si el parámetro cbStoreRecordKey es mayor que cero, el parámetro pszMsgID apunta a un identificador de entrada compuesto convertido en texto. Si cbStoreRecordKey es cero, pszMsgID apunta a un identificador de entrada no completo convertido en texto.

Valor devuelto

Ninguno.

Comentarios

Si el mensaje u otro objeto para el que se crea el identificador de entrada compuesto reside en un almacén de mensajes, la cadena de identificador se crea a partir del identificador de entrada del objeto y de la clave de registro del almacén. Si el objeto no está en un almacén, es decir, si el recuento de bytes de la clave de registro de almacén pasada en el parámetro cbStoreRecordKey es cero, el identificador de entrada del objeto simplemente se copia y convierte en una cadena.

Llamar a la función HrComposeMsgID equivale a llamar a la función HrComposeEID y, a continuación, a la función HrSzFromEntryID .

HrComposeMsgID permite a las aplicaciones cliente trabajar con objetos de varios almacenes mediante el uso de identificadores de entrada compuestos. Una aplicación puede llamar a la función HrDecomposeMsgID para dividir el identificador de entrada compuesta en sus constituyentes originales.