Fungsi GetNtmsMediaPoolNameA (ntmsapi.h)

[Manajer Penyimpanan yang Dapat Dilepas tidak lagi tersedia pada Windows 7 dan Windows Server 2008 R2.]

Fungsi GetNtmsMediaPoolName mengambil hierarki nama lengkap kumpulan media yang ditentukan.

Sintaks

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

Parameter

[in] hSession

Tangani ke sesi yang dikembalikan oleh fungsi OpenNtmsSession .

[in] lpPoolId

Pengidentifikasi unik kumpulan media yang namanya akan diambil.

[out] lpNameBuf

Penunjuk ke buffer yang menerima nama kumpulan media.

[in, out] lpdwBufSize

Ukuran buffer lpBufName , pada input. Pada output, jumlah karakter dalam hierarki nama lengkap.

Mengembalikan nilai

Fungsi ini mengembalikan salah satu nilai berikut.

Nilai	Makna
ERROR_INSUFFICIENT_BUFFER	Ukuran buffer tidak cukup besar. Ukuran yang benar dikembalikan dalam lpdwBufSize.
ERROR_INVALID_HANDLE	Nilai yang ditentukan dalam parameter hSession adalah NULL atau tidak valid.
ERROR_INVALID_MEDIA_POOL	ID kumpulan media hilang atau tidak valid.
ERROR_INVALID_PARAMETER	Parameter hilang atau tidak valid.
ERROR_NOT_ENOUGH_MEMORY	Alokasi memori gagal.
ERROR_SUCCESS	Fungsi berhasil.

Keterangan

Catatan

Header ntmsapi.h mendefinisikan GetNtmsMediaPoolName sebagai alias yang secara otomatis memilih versi ANSI atau Unicode dari fungsi ini berdasarkan definisi konstanta praprosedur UNICODE. Mencampur penggunaan alias encoding-netral dengan kode yang tidak mengodekan-netral dapat menyebabkan ketidakcocokan yang mengakibatkan kesalahan kompilasi atau runtime. Untuk informasi selengkapnya, lihat Konvensi untuk Prototipe Fungsi.

Persyaratan

Klien minimum yang didukung	Windows XP [hanya aplikasi desktop]
Server minimum yang didukung	Windows Server 2003 [hanya aplikasi desktop]
Target Platform	Windows
Header	ntmsapi.h
Pustaka	Ntmsapi.lib
DLL	Ntmsapi.dll

Lihat juga

CreateNtmsMediaPool

Fungsi Media Services