次の方法で共有

SetNtmsUIOptionsA 関数 (ntmsapi.h)

  • [アーティクル]

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

SetNtmsUIOptions 関数は、指定した種類の UI が指定されたオブジェクトに対して転送されるコンピューター名の一覧を変更します。

構文

DWORD SetNtmsUIOptionsA(
  [in]  HANDLE            hSession,
  [in]  const LPNTMS_GUID lpObjectId,
  [in]  DWORD             dwType,
  [in]  DWORD             dwOperation,
  [out] LPCSTR            lpszDestination
);

パラメーター

[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 メッセージ。 これには、エラー通知に関連するオペレーター要求が含まれます。 たとえば、ドライブをクリーンアップする要求などです。

[in] dwOperation

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

価値 意味
NTMS_UIDEST_ADD
 新しい宛先 (コンピューター名) を一覧に追加します。
NTMS_UIDEST_DELETE
 リストから宛先を削除します。
NTMS_UIDEST_DELETEALL
 リストからすべての宛先をクリアします。 オブジェクトの UI は生成されません。 この場合、変換先の引数は無視されます。

[out] lpszDestination

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

戻り値

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

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

備考

setNtmsUIOptions 呼び出すと、lpObjectId および dwType パラメーターによって決定される特定のインスタンスの宛先 追加または削除されます。

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

セキュリティ チェックは、SetNtmsUIOptions呼び出すときに実行されることに注意してください。 コンピューター オブジェクトが指定されている場合は、コンピューターを変更するためのアクセス許可を持つ必要があります。 ライブラリの UI 要素を変更する場合は、ライブラリ オブジェクトを変更するためのアクセス許可を持つ必要があります。

宛先文字列のチェックは行われません。 SetNtmsUIOptions 呼び出されたコンピューターから到達可能なコンピューターではない宛先名を持つ呼び出し 成功を返します。 ローカル コンピューターを意味する空の文字列へのポインターが取得されます。

手記

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

必要条件

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

関連項目

GetNtmsUIOptions の

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