GetNtmsMediaPoolNameW-Funktion (ntmsapi.h)
[Wechseldatenträger-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 GetNtmsMediaPoolNameW(
[in] HANDLE hSession,
[in] LPNTMS_GUID lpPoolId,
[out] LPWSTR 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 |
---|---|
|
Die Puffergröße ist nicht groß genug. Die richtige Größe wird in lpdwBufSize zurückgegeben. |
|
Der im hSession-Parameter angegebene Wert ist NULL oder ungültig. |
|
Die Medienpool-ID fehlt oder ist ungültig. |
|
Der Parameter fehlt oder ist ungültig. |
|
Fehler bei der Speicherzuordnung. |
|
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 nicht codierungsneutralem Code 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
Feedback
https://aka.ms/ContentUserFeedback.
Bald verfügbar: Im Laufe des Jahres 2024 werden wir GitHub-Issues stufenweise als Feedbackmechanismus für Inhalte abbauen und durch ein neues Feedbacksystem ersetzen. Weitere Informationen finden Sie unterFeedback senden und anzeigen für