共用方式為

GetNtmsMediaPoolNameW 函式 （ntmsapi.h）

  • 發行項

[ 從 Windows 7 和 Windows Server 2008 R2 起，卸除式存儲設備管理員 已無法使用。]

GetNtmsMediaPoolName 函式會擷取指定的媒體集區完整名稱階層。

語法

DWORD GetNtmsMediaPoolNameW(
  [in]      HANDLE      hSession,
  [in]      LPNTMS_GUID lpPoolId,
  [out]     LPWSTR      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
 媒體集區標識碼遺失或無效。
ERROR_INVALID_PARAMETER
 參數遺失或無效。
ERROR_NOT_ENOUGH_MEMORY
 記憶體配置失敗。
ERROR_SUCCESS
 函式成功。

言論

注意

ntmsapi.h 標頭會根據 UNICODE 預處理器常數的定義，將 GetNtmsMediaPoolName 定義為自動選取此函式的 ANSI 或 Unicode 版本。 混合使用編碼中性別名與非編碼中性的程序代碼，可能會導致編譯或運行時間錯誤不符。 如需詳細資訊，請參閱函式原型的 慣例。

要求

要求 價值
最低支援的用戶端 Windows XP [僅限傳統型應用程式]
支援的最低伺服器 Windows Server 2003 [僅限傳統型應用程式]
目標平臺 窗戶
標頭 ntmsapi.h
連結庫 Ntmsapi.lib
DLL Ntmsapi.dll

另請參閱

CreateNtmsMediaPool

媒體服務函式