GetNtmsMediaPoolNameA-Funktion (ntmsapi.h)

  • Artikel

[Wechselmedien-Manager ist ab Windows 7 und Windows Server 2008 R2 nicht mehr verfügbar.]

Die GetNtmsMediaPoolName-Funktion ruft die vollständige Namenshierarchie des angegebenen Medienpools ab.

Syntax

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

Parameter

[in] hSession

Handle für die von der OpenNtmsSession-Funktion zurückgegebene Sitzung.

[in] lpPoolId

Eindeutiger Bezeichner des Medienpools, dessen Name abgerufen werden soll.

[out] lpNameBuf

Zeiger auf einen Puffer, der den Namen des Medienpools empfängt.

[in, out] lpdwBufSize

Größe des lpBufName-Puffers bei Eingabe. Bei der Ausgabe die Anzahl der Zeichen in der vollständigen Namenshierarchie.

Rückgabewert

Diese Funktion gibt einen der folgenden Werte zurück.

Wert Bedeutung
ERROR_INSUFFICIENT_BUFFER
 Die Puffergröße ist nicht groß genug. Die richtige Größe wird in lpdwBufSize zurückgegeben.
ERROR_INVALID_HANDLE
 Der im hSession-Parameter angegebene Wert ist NULL oder ungültig.
ERROR_INVALID_MEDIA_POOL
 Die Medienpool-ID fehlt oder ist ungültig.
ERROR_INVALID_PARAMETER
 Der Parameter fehlt oder ist ungültig.
ERROR_NOT_ENOUGH_MEMORY
 Fehler bei der Speicherbelegung.
ERROR_SUCCESS
 Die Funktion war erfolgreich.

Hinweise

Hinweis

Der ntmsapi.h-Header definiert GetNtmsMediaPoolName als Alias, der die ANSI- oder Unicode-Version dieser Funktion basierend auf der Definition der UNICODE-Präprozessorkonstante automatisch auswählt. Das Mischen der Verwendung des codierungsneutralen Alias mit Code, der nicht Codierungsneutral ist, kann zu Nichtübereinstimmungen führen, die zu Kompilierungs- oder Laufzeitfehlern führen. Weitere Informationen finden Sie unter Konventionen für Funktionsprototypen.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Windows XP [nur Desktop-Apps]
Unterstützte Mindestversion (Server) Windows Server 2003 [nur Desktop-Apps]
Zielplattform Windows
Kopfzeile ntmsapi.h
Bibliothek Ntmsapi.lib
DLL Ntmsapi.dll

Weitere Informationen

CreateNtmsMediaPool

Media Services-Funktionen