CreateNtmsMediaPoolW 関数 (ntmsapi.h)

[アーティクル]
11/20/2024

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

CreateNtmsMediaPool 関数は、新しいアプリケーションメディアプールを作成します。

構文

DWORD CreateNtmsMediaPoolW(
  [in]  HANDLE                hSession,
  [in]  LPCWSTR               lpPoolName,
  [in]  LPNTMS_GUID           lpMediaType,
  [in]  DWORD                 dwAction,
  [in]  LPSECURITY_ATTRIBUTES lpSecurityAttributes,
  [out] LPNTMS_GUID           lpPoolId
);

パラメーター

[in] hSession

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

[in] lpPoolName

新しいメディアプールの名前。メディアプール名は、単一の RSM データベースのスコープ内で一意である必要があります。

[in] lpMediaType

このメディアプール内のメディアの種類の識別子。 EnumerateNtmsObject 関数を使用して、使用可能なメディアの種類とその属性の一覧を取得します。アプリケーションは、NULL ポインターを渡して、他のメディアプールのみを含むメディアプールを作成できます。

[in] dwAction

実行するアクション。このパラメーターは、次のいずれかの値である必要があります。

価値	意味
NTMS_OPEN_EXISTING	既存のメディアプールを名前で開きます。プールが存在しない場合はERROR_OBJECT_NOT_FOUNDを返します。
NTMS_OPEN_ALWAYS	既存のメディアプールを開くか、存在しない場合はプールを作成します。
NTMS_CREATE_NEW	新しいメディアプールを作成します。プールが存在する場合はERROR_ALREADY_EXISTSを返します。

[in] lpSecurityAttributes

プールへのアクセスを制限するために使用されるオプションのセキュリティ記述子。

[out] lpPoolId

メディアプールが正常に作成または開かれた後に、メディアプールの一意識別子を受け取る変数へのポインター。

戻り値

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

価値	意味
ERROR_ACCESS_DENIED	ルートプールまたは親メディアプールへのNTMS_CONTROL_ACCESSは、新しいメディアプールの作成中に拒否されます。その他のセキュリティエラーも考えられますが、セキュリティサブシステムエラーを示します。 Windows XP: 新しいメディアプールを作成しようとすると、親メディアプールへの NTMS_MODIFY_ACCESS が拒否されます。その他のセキュリティエラーも考えられますが、セキュリティサブシステムエラーを示します。
ERROR_ALREADY_EXISTS	この名前のメディアプールが既に存在するため、新しいメディアプールを作成できません。
ERROR_DATABASE_FAILURE	データベースにアクセスできないか、破損しています。
ERROR_DATABASE_FULL	データベースがいっぱいです。その他のセキュリティエラーも考えられますが、セキュリティサブシステムエラーを示します。
ERROR_INVALID_HANDLE	セッションハンドルが見つからないか、無効です。
ERROR_INVALID_MEDIA	選択したメディアの種類が無効です。
ERROR_INVALID_NAME	プール名の構文が無効です。 (名前が長すぎます)。
ERROR_INVALID_PARAMETER	メディアプール名またはメディアプール ID ポインターがありません。
ERROR_OBJECT_NOT_FOUND	既存のメディアプールを開くことができません。
ERROR_SUCCESS	関数が成功しました。

備考

Free、Unrecognized、Import メディアプールは RSM によって作成され、CreateNtmsMediaPool 関数では作成できません。

RSM メディアプールは、"" 文字で区切られた階層として編成されます。アプリケーション、Free、Unrecognized、Import メディアプールは、階層のルートに存在します。 RSM は、Free プール、Unrecognized プール、Import プールを作成して管理します。 RSM は、使用可能なメディアの種類ごとに Free メディアプールを作成します。

アプリケーション固有のメディアプールは、アプリケーションによって作成されます。アプリケーションは、ルートアプリケーションプールの下に独自に使用するメディアプールを作成します。これらのメディアプールには、ファイルシステムに似た名前があります。名前のエンドポイントにのみメディアとポリシーが含まれます。アプリケーションでは、\MyApp\Pool1 や \MyApp\Pool2 などのプールを定義できます。これにより、階層がユーザーインターフェイスに伝達され、重複する名前が回避されます。各プールレベルは個別に作成する必要があります。フォルダーやファイルと同様に、最初の MyApp、Pool1、Pool2。

Windows Server 2003: メディアプールを作成するには、ルートプールと親プールへのNTMS_CONTROL_ACCESSが必要です。セキュリティ記述子が指定されていない場合、プールは親プールの ACE を継承します (親プールがルートプールでない場合)。さらに、作成者アカウントとローカルシステムアカウントは、プールへのフルアクセス権を持っています。親プールがルートプールの場合、その ACE は継承されません。DACL 内の唯一の ACE は、作成者およびローカルシステムアカウントに対するフルアクセスです。

手記

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

必要条件

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

次の方法で共有

CreateNtmsMediaPoolW 関数 (ntmsapi.h)

構文

パラメーター

戻り値

備考

必要条件

関連項目

フィードバック

その他のリソース