HrComposeEID
Gilt für: Outlook 2013 | Outlook 2016
Erstellt einen zusammengesetzten Eintragsbezeichner für ein Objekt, in der Regel eine Nachricht in einem Nachrichtenspeicher.
Eigenschaft | Wert |
---|---|
Headerdatei |
Mapiutil.h |
Implementiert von: |
MAPI |
Aufgerufen von: |
Clientanwendungen |
HrComposeEID(
LPMAPISESSION psession,
ULONG cbStoreRecordKey,
LPBYTE pStoreRecordKey,
ULONG cbMsgEID,
LPENTRYID pMsgEID,
ULONG FAR * pcbEID,
LPENTRYID FAR * ppEID
);
Parameter
psession
[in] Zeiger auf die Sitzung, die von der Clientanwendung verwendet wird.
cbStoreRecordKey
[in] Größe des Datensatzschlüssels des Nachrichtenspeichers, der die Nachricht oder ein anderes Objekt enthält, in Bytes. Wenn null im cbStoreRecordKey-Parameter übergeben wird, verweist der ppEID-Parameter auf eine Kopie des Eintragsbezeichners des Objekts.
pStoreRecordKey
[in] Zeiger auf den Datensatzschlüssel des Nachrichtenspeichers, der die Nachricht oder ein anderes Objekt enthält.
cbMsgEID
[in] Größe des Eintragsbezeichners der Nachricht oder eines anderen Objekts in Bytes.
pMsgEID
[in] Zeiger auf den Eintragsbezeichner des Objekts.
pcbEID
[out] Zeiger auf die Größe des zurückgegebenen Bezeichners in Bytes.
ppEID
[out] Zeiger auf einen Zeiger auf den zurückgegebenen Eintragsbezeichner. Wenn der Wert des cbStoreRecordKey-Parameters größer als 0 (null) ist, verweist der ppEID-Parameter auf einen Zeiger auf den zusammengesetzten Eintragsbezeichner, der erstellt wird. Wenn cbStoreRecordKey null ist, verweist ppEID auf einen Zeiger auf eine Kopie des Eintragsbezeichners des Objekts.
Rückgabewert
None.
Hinweise
Wenn sich die Nachricht oder ein anderes Objekt, für das der Verbundeintragsbezeichner erstellt wird, in einem Nachrichtenspeicher befindet, wird der Bezeichner aus dem Eintragsbezeichner des Objekts und dem Datensatzschlüssel des Speichers erstellt. Wenn sich das Objekt nicht in einem Speicher befindet, d. h. wenn die Byteanzahl für den in cbStoreRecordKey übergebenen Speicherdatensatzschlüssel null ist, wird der Eintragsbezeichner des Objekts einfach kopiert.
Die HrComposeEID-Funktion ermöglicht Es Anwendungen, mit Objekten in mehreren Speichern zu arbeiten, indem Verbundeintragsbezeichner verwendet werden. Eine Anwendung kann die HrDecomposeEID-Funktion aufrufen, um den Verbundeintragsbezeichner in seine ursprünglichen Bestandteile aufzuteilen.