IMAPISupport::NewUID
適用対象: Outlook 2013 | Outlook 2016
一意識別子として使用する新しい MAPIUID 構造体を作成します。
HRESULT NewUID(
LPMAPIUID lpMuid
);
パラメーター
lpMuid
新しい MAPIUID 構造体へのポインター。
戻り値
S_OK
新しい MAPIUID 構造体が作成されました。
注釈
IMAPISupport::NewUID メソッドは、すべてのサポート オブジェクトに対して実装されます。 サービス プロバイダーとメッセージ サービスは、長期的な一意識別子を生成する必要がある場合は常に NewUID を呼び出します。 たとえば、メッセージ ストア プロバイダーは NewUID を呼び出して、新しく作成されたメッセージのPR_SEARCH_KEY (PidTagSearchKey) プロパティに配置する MAPIUID を取得します。
呼び出し側への注意
ログオン時に登録する MAPIUID 構造体を、NewUID メソッドが作成する MAPIUID 構造体と混同しないでください。 IMAPISupport::SetProviderUID メソッドを呼び出すときに登録する MAPIUID 構造体は、MAPI に対するアドレス帳またはメッセージ ストア プロバイダーを表し、さまざまなプロバイダーが作成するエントリ識別子を区別するために使用されます。 この MAPIUID 構造体はハードコーディングする必要があり、 NewUID の呼び出しによって取得されません。