HrComposeMsgID

適用対象: Outlook 2013 | Outlook 2016

オブジェクトの複合エントリ識別子 (通常はメッセージ ストア内のメッセージ) を表す ASCII 文字列を作成します。

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

パラメーター

psession

[in]クライアント アプリケーションで使用されているセッションへのポインター。

cbStoreRecordKey

[in]メッセージまたはその他のオブジェクトを含むメッセージ ストアのレコード キーのサイズ (バイト単位)。 cbStoreRecordKey パラメーターに 0 が渡された場合、pszMsgID パラメーターは、テキストに変換されたエントリ識別子のコピーを指します。

pStoreRecordKey

[in]メッセージまたはその他のオブジェクトを含むメッセージ ストアのレコード キーへのポインター。

cbMsgEID

[in]メッセージまたはその他のオブジェクトのエントリ識別子のサイズ (バイト単位)。

pMsgEID

[in]オブジェクトのエントリ識別子へのポインター。

pszMsgID

[out]返された ASCII 文字列へのポインター。 cbStoreRecordKey パラメーターが 0 より大きい場合、pszMsgID パラメーターはテキストに変換された複合エントリ識別子を指します。 cbStoreRecordKey が 0 の場合、pszMsgID はテキストに変換された非コンパイルエントリ識別子を指します。

戻り値

なし。

注釈

複合エントリ識別子が作成されているメッセージまたはその他のオブジェクトがメッセージ ストアに存在する場合、識別子文字列はオブジェクトのエントリ識別子とストアのレコード キーから作成されます。 オブジェクトがストアにない場合、つまり、 cbStoreRecordKey パラメーターで渡されるストア レコード キーのバイト数が 0 の場合、オブジェクトのエントリ識別子は単にコピーされ、文字列に変換されます。

HrComposeMsgID 関数の呼び出しは、HrComposeEID 関数を呼び出してから HrSzFromEntryID 関数を呼び出すことと同じです。

HrComposeMsgID を使用すると、クライアント アプリケーションは複合エントリ識別子を使用して、複数のストア内のオブジェクトを操作できます。 アプリケーションは HrDecomposeMsgID 関数を呼び出して、複合エントリ識別子を元の構成要素に分割できます。