次の方法で共有

OpenNtmsSessionA 関数 (ntmsapi.h)

  • [アーティクル]

[リムーバブル 記憶域マネージャー は、Windows 7 および Windows Server 2008 R2 以降では使用できません。

OpenNtmsSession 関数は、RSM サーバーとのセッションを設定します。

構文

HANDLE OpenNtmsSessionA(
  [in] LPCSTR lpServer,
  [in] LPCSTR lpApplication,
       DWORD  dwOptions
);

パラメーター

[in] lpServer

RSM サーバー名。 このパラメーターが NULL の場合は、現在のコンピューター名が使用されます。

[in] lpApplication

アプリケーションを識別する一意の文字列。 この名前は、リソースとオペレーターの要求を識別します。 このパラメーターは省略可能であり、 NULL にすることができます。

dwOptions

予約;は 0 である必要があります。

戻り値

OpenNtmsSession が成功すると、このセッションを一意に識別するハンドルが返されます。 関数が失敗した場合は、INVALID_HANDLE_VALUEを返します。 詳細を取得するには、 GetLastError 関数を呼び出します。 この関数は、次のいずれかの値を返すことができます。

値 意味
ERROR_INVALID_COMPUTERNAME
 指定されたコンピューター名の形式が有効な形式ではありません。
ERROR_INVALID_PARAMETER
 パラメーター値の 1 つが無効でした。
ERROR_NO_NETWORK
 ネットワークが開始されていないか、使用できません。
ERROR_NOT_CONNECTED
 RSM サービスに接続できません。
ERROR_NOT_READY
 RSM サービスが開始されていません。 アプリケーションは待機して再試行する必要があります。
ERROR_SUCCESS
 関数は成功しました。
INVALID_HANDLE_VALUE
 RSM はセッションを開くことができません。
RPC_S_NO_INTERFACES
 このサービスでは、アプリケーションよりも古いバージョンの RSM が使用されています。

注釈

OpenNtmsSession 関数は、他の RSM 関数で使用されるセッション ハンドルを返し、RSM データベースとの接続を確立し、アプリケーションの RSM サブシステムを初期化します。

OpenNtmsSession が返されると、アプリケーションは RSM 操作を実行できます。

セッションはスレッド セーフですが、プロセス間で渡すことはできません。

注意

ntmsapi.h ヘッダーは、OpenNtmsSession をエイリアスとして定義し、UNICODE プリプロセッサ定数の定義に基づいて、この関数の ANSI または Unicode バージョンを自動的に選択します。 encoding-neutral エイリアスの使用を encoding-neutral ではないコードと混在すると、コンパイル エラーまたはランタイム エラーが発生する不一致が発生する可能性があります。 詳細については、「 関数プロトタイプの規則」を参照してください。

要件

要件 値
サポートされている最小のクライアント Windows XP (デスクトップ アプリのみ)
サポートされている最小のサーバー Windows Server 2003 (デスクトップ アプリのみ)
対象プラットフォーム Windows
ヘッダー ntmsapi.h
Library Ntmsapi.lib
[DLL] Ntmsapi.dll

こちらもご覧ください

CloseNtmsSession

セッション管理機能