GetNtmsMediaPoolNameA-Funktion (ntmsapi.h)

Artikel
11/20/2024

[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

Behandeln Sie die sitzung, die von der OpenNtmsSession--Funktion zurückgegeben wird.

[in] lpPoolId

Eindeutiger Bezeichner des Medienpools, dessen Name abgerufen werden soll.

[out] lpNameBuf

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

[in, out] lpdwBufSize

Die Größe des lpBufName Puffers bei eingaben. 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 lpdwBufSizezurü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 Speicherzuweisung.
ERROR_SUCCESS	Die Funktion war erfolgreich.

Bemerkungen

Anmerkung

Der ntmsapi.h-Header definiert GetNtmsMediaPoolName als Alias, der automatisch die ANSI- oder Unicode-Version dieser Funktion basierend auf der Definition der UNICODE-Präprozessorkonstante 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
mindestens unterstützte Client-	Windows XP [nur Desktop-Apps]
mindestens unterstützte Server-	Windows Server 2003 [Nur Desktop-Apps]
Zielplattform-	Fenster
Header-	ntmsapi.h
Library	Ntmsapi.lib
DLL-	Ntmsapi.dll

Siehe auch

CreateNtmsMediaPool-

Media Services-Funktionen

Freigeben über