次の方法で共有

GetNtmsUIOptionsW 関数 (ntmsapi.h)

  • [アーティクル]

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

GetNtmsUIOptions 関数は、指定した種類のユーザー インターフェイスが指定されたオブジェクトに対して転送されるコンピューター名の一覧を取得します。 getNtmsUIOptions 呼び出すと、lpObjectId および dwType パラメーターによって決定されるインスタンスの宛先の一覧 返されます。

指定したインスタンスのリストに宛先がない場合、関数はリストの長さ 0 と共にERROR_SUCCESSを返します。

構文

DWORD GetNtmsUIOptionsW(
  [in]      HANDLE            hSession,
  [in]      const LPNTMS_GUID lpObjectId,
  [in]      DWORD             dwType,
  [out]     LPWSTR            lpszDestination,
  [in, out] LPDWORD           lpdwBufSize
);

パラメーター

[in] hSession

OpenNtmsSession 関数によって返されるセッションへのハンドル。

[in] lpObjectId

UI がリダイレクトされるオブジェクトの一意識別子。 オブジェクトは、イベントのソースとして使用できるコンテナーである必要があります。 オブジェクトは、アプリケーション (アプリケーションによってトリガーされるマウント要求)、ライブラリ (取り出しに応答するドアを開く要求)、またはコンピューター (コンピューターに関連するすべての UI) のいずれかです。

コンピューター コンテナーを指定するには、リムーバブル 記憶域マネージャーのコンピューター オブジェクト GUID を使用してバッファーを指す ポインター lpObjectId を設定します。 特定のライブラリを指定するには、ライブラリの GUID を持つバッファーを指すよう設定します。 アプリケーションを指定するには、NULL ポインターを渡します。 アプリケーションの ID は、hSessionで使用されるセッションによって決まります。 1 つのアプリケーションで複数のセッションを同時に開くことができます。 この場合、値セットは、hSession セッションにのみ適用されます。

[in] dwType

このパラメーターには、次のいずれかの値を指定できます。

価値 意味
NTMS_UITYPE_INFO
 情報を提供する UI メッセージ。 これには、進行状況を示す作業キュー項目が含まれます。 たとえば、要求をマウントします。
NTMS_UITYPE_REQ
 要求である UI メッセージ。 これには、メディアを処理するオペレーター要求が含まれます。 たとえば、新しいメディアを挿入する要求などです。
NTMS_UITYPE_ERR
 エラー情報を提供する UI メッセージ。 これには、エラー通知に関連するオペレーター要求が含まれます。 たとえば、ドライブをクリーンアップする要求などです。

[out] lpszDestination

UI がリダイレクトされるマシンの名前を返す複数文字列。 このパラメーターは NULLできません。

[in, out] lpdwBufSize

変換先の文字列のサイズ (TCHAR)。

戻り値

この関数は、次のいずれかの値を返します。

価値 意味
ERROR_ACCESS_DENIED
 1 つ以上の RSM オブジェクトへのアクセスが拒否されます。
ERROR_INSUFFICIENT_BUFFER
 lpdwSize で指定 バッファー サイズが見つかった宛先に対して小さすぎます。 この関数は、lpdwSize実際のサイズを返します。
ERROR_INVALID_HANDLE
 セッション ハンドルが見つからないか、無効です。
ERROR_INVALID_PARAMETER
 lpdwSize または lpszDestination パラメーターが NULL、または lpObjectId が有効なコンテナーではない 、または dwType が 3 つの有効な値の 1 つではありません。
ERROR_NOT_ENOUGH_MEMORY
 処理中に割り当てエラーが発生しました。
ERROR_OBJECT_NOT_FOUND
 lpObjectId で指定された GUID は、データベース内のコンピューターまたはライブラリ オブジェクトの GUID ではありません。
ERROR_SUCCESS
 関数が成功しました。

備考

GetNtmsUIOptions 呼び出すと、lpObjectId および dwType パラメーターによって決定される特定のインスタンスの宛先の一覧 返されます。

  NTMS_UITYPE_INFO NTMS_UITYPE_REQ NTMS_UITYPE_ERR
アプリケーション このアプリケーションによって生成された作業項目の作業項目の進行状況 UI を表示します。 このアプリケーションによって実行されたアクションによって生成されたオペレーター要求のオペレーター要求 UI を表示します。 未定義。 アプリケーションでは、この種のエラー イベントを発生させることはできません。
図書館 このライブラリに関連付けられている作業項目の作業項目の進行状況 UI を表示します。 このライブラリに関連付けられている要求の UI を表示します。 このライブラリに関連付けられているエラーの UI を表示します。
コンピュータ このマシンで実行されている RSM のこのインスタンスに情報 UI を表示します。 RSM のこのインスタンスに要求の種類の UI を表示します。 RSM のこのインスタンスにエラーの種類の UI を表示します。
 

手記

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

必要条件

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

関連項目

ライブラリ コントロール関数の

SetNtmsUIOptions の