IMSProvider::SpoolerLogon

[アーティクル]
04/04/2023

適用対象: Outlook 2013 | Outlook 2016

MAPI スプーラーをメッセージストアにログに記録します。

HRESULT SpoolerLogon(
  LPMAPISUP lpMAPISup,
  ULONG_PTR ulUIParam,
  LPSTR lpszProfileName,
  ULONG cbEntryID,
  LPENTRYID lpEntryID,
  ULONG ulFlags,
  LPCIID lpInterface,
  ULONG cbSpoolSecurity,
  LPBYTE lpbSpoolSecurity,
  LPMAPIERROR FAR * lppMAPIError,
  LPMSLOGON FAR * lppMSLogon,
  LPMDB FAR * lppMDB     
);

パラメーター

lpMAPISup

[in]メッセージストアの MAPI サポートオブジェクトへのポインター。

ulUIParam

[in]このメソッドが表示するダイアログボックスまたはウィンドウの親ウィンドウへのハンドル。

lpszProfileName

[in]MAPI スプーラーログオンに使用されているプロファイルの名前を含む文字列へのポインター。この文字列は、ダイアログボックスに表示したり、ログファイルに書き込んだり、単に無視したりできます。 ulFlags パラメーターに MAPI_UNICODE フラグが設定されている場合は、Unicode 形式にする必要があります。

cbEntryID

[in] lpEntryID パラメーターによって指されるエントリ識別子のサイズ (バイト単位)。

lpEntryID

[in]メッセージストアのエントリ識別子へのポインター。 lpEntryID パラメーターに NULL を渡すと、メッセージストアがまだ選択されておらず、ユーザーがメッセージストアを選択できるようにするダイアログボックスを表示できることを示します。

ulFlags

[in]ログオンの実行方法を制御するフラグのビットマスク。次のフラグを設定できます。

MAPI_DEFERRED_ERRORS

基になるオブジェクトが呼び出し元の実装で使用できない場合でも、呼び出しは成功できます。オブジェクトが使用できない場合は、オブジェクトの後続の呼び出しでエラーが発生する可能性があります。

MAPI_UNICODE

渡された文字列は Unicode 形式です。 MAPI_UNICODEが設定されていない場合、文字列は ANSI 形式です。

MDB_NO_DIALOG

ログオンダイアログボックスが表示されないようにします。このフラグが設定されている場合、ログオンが失敗した場合MAPI_E_LOGON_FAILEDエラー値が返されます。このフラグが設定されていない場合、メッセージストアプロバイダーは、名前またはパスワードの修正、ディスクの挿入、またはストアへの接続を確立するために必要なその他のアクションの実行をユーザーに求めることができます。

MDB_WRITE

読み取り/書き込みアクセス許可を要求します。

lpInterface

[in]ログオンするメッセージストアのインターフェイス識別子 (IID) へのポインター。 NULL を渡すと、メッセージストア (IMsgStore) の MAPI インターフェイスが返されます。 lpInterface パラメーターは、メッセージストアの適切なインターフェイスの識別子 (IID_IUnknownやIID_IMAPIPropなど) に設定することもできます。

cbSpoolSecurity

[in] lppbSpoolSecurity パラメーターの検証データのサイズ (バイト単位) へのポインター。

lpbSpoolSecurity

[in]検証データへのポインター。 SpoolerLogon メソッドは、このデータを使用して、IMSProvider::Logon メソッドを使用して、以前にログオンしたメッセージストアプロバイダーと同じストアに MAPI スプーラーをログに記録します。

lppMAPIError

[out]エラーのバージョン、コンポーネント、コンテキスト情報を含む、返された MAPIERROR 構造体へのポインター (存在する場合)。返す MAPIERROR 構造体がない場合は、lppMAPIError パラメーターを NULL に設定できます。

lppMSLogon

[out]MAPI がログオンするためのメッセージストアログオンオブジェクトへのポインター。

lppMDB

[out]MAPI スプーラーとクライアントアプリケーションがログオンするメッセージストアオブジェクトへのポインターへのポインター。

戻り値

S_OK

�ʘb��A�\��l�܂��͒l��Ԃ��܂��B

MAPI_E_UNCONFIGURED

プロファイルには、ログオンを完了するための十分な情報が含まれていません。この値が返されると、MAPI はメッセージストアプロバイダーのメッセージサービスエントリポイント関数を呼び出します。

MAPI_W_ERRORS_RETURNED

呼び出しは成功しましたが、メッセージストアプロバイダーにエラー情報が表示されます。この警告が返されたら、呼び出しは成功として処理する必要があります。この警告をテストするには、 HR_FAILED マクロを使用します。詳細については、「エラー処理にマクロを使用する」を参照してください。プロバイダーからエラー情報を取得するには、 IMAPISession::GetLastError メソッドを呼び出します。

注釈

MAPI スプーラーは 、IMSProvider::SpoolerLogon メソッドを呼び出してメッセージストアにログオンします。 MAPI スプーラーは、ログオン中とログオン後に lppMDB パラメーターでメッセージストアプロバイダーによって返されるメッセージストアオブジェクトを使用する必要があります。

IMSProvider::Logon メソッドとの整合性を確保するために、プロバイダーは lppMSLogon パラメーターにメッセージストアログオンオブジェクトも返します。ストアオブジェクトとログオンオブジェクトの使用は、通常のストアログオンと同じです。ログオンオブジェクトとストアオブジェクトの間には、オブジェクトが 2 つのインターフェイスを公開する 1 つのオブジェクトであるかのように動作するように、1 対 1 の対応が必要です。 2 つのオブジェクトは一緒に作成され、一緒に解放されます。

ストアプロバイダーは、MAPI スプーラーによってストアが使用されていることを示すために、返されたメッセージストアオブジェクトを内部的にマークする必要があります。このストアオブジェクトのメソッドの一部は、クライアントアプリケーションに提供されるメッセージストアオブジェクトの場合とは動作が異なります。この内部マークを保持することは、MAPI スプーラーに固有の動作をトリガーする最も一般的な方法です。

次の方法で共有

IMSProvider::SpoolerLogon

パラメーター

戻り値

注釈

関連項目

フィードバック

その他のリソース