Freigeben über

GetNtmsMediaPoolNameA-Funktion (ntmsapi.h)

[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

  • Last updated on