Fungsi GetNtmsMediaPoolNameA (ntmsapi.h)

  • Artikel

[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.

Nilai kembali

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 pra-prosesor 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

Persyaratan Nilai
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