次の方法で共有


GetNtmsMediaPoolNameA 関数 (ntmsapi.h)

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

GetNtmsMediaPoolName 関数は、指定されたメディア プールのフル ネーム階層を取得します。

構文

DWORD GetNtmsMediaPoolNameA(
  [in]      HANDLE      hSession,
  [in]      LPNTMS_GUID lpPoolId,
  [out]     LPSTR       lpNameBuf,
  [in, out] LPDWORD     lpdwBufSize
);

パラメーター

[in] hSession

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

[in] lpPoolId

名前を取得するメディア プールの一意識別子。

[out] lpNameBuf

メディア プールの名前を受け取るバッファーへのポインター。

[in, out] lpdwBufSize

入力時の lpBufName バッファーのサイズ。 出力時に、フル ネーム階層内の文字数。

戻り値

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

価値 意味
ERROR_INSUFFICIENT_BUFFER
バッファー サイズが十分な大きさではありません。 lpdwBufSizeでは、正しいサイズ 返されます。
ERROR_INVALID_HANDLE
hSession パラメーターで指定された値が NULL 、または無効です。
ERROR_INVALID_MEDIA_POOL
メディア プール ID が見つからないか、無効です。
ERROR_INVALID_PARAMETER
パラメーターが見つからないか、無効です。
ERROR_NOT_ENOUGH_MEMORY
メモリ割り当てに失敗しました。
ERROR_SUCCESS
関数が成功しました。

備考

手記

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

必要条件

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

関連項目

CreateNtmsMediaPool を する

Media Services Functions