次の方法で共有

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 ヘッダーは、Unicode プリプロセッサ定数の定義に基づいて、この関数の ANSI または Unicode バージョンを自動的に選択するエイリアスとして OpenNtmsSession を定義します。 エンコードに依存しないエイリアスをエンコードに依存しないコードと組み合わせて使用すると、コンパイルエラーやランタイム エラーが発生する不一致が発生する可能性があります。 詳細については、「関数プロトタイプの 規則」を参照してください。

必要条件

要件 価値
サポートされる最小クライアント Windows XP [デスクトップ アプリのみ]
サポートされる最小サーバー Windows Server 2003 [デスクトップ アプリのみ]
ターゲット プラットフォーム の ウィンドウズ
ヘッダー ntmsapi.h
ライブラリ Ntmsapi.lib
DLL Ntmsapi.dll

関連項目

CloseNtmsSession を する

セッション管理機能の