GetNtmsMediaPoolNameA-Funktion (ntmsapi.h)
[Wechselspeicher-Manager ist nicht mehr als Windows 7 und Windows Server 2008 R2 verfügbar.]
Die Funktion GetNtmsMediaPoolName ruft die vollständige Namenhierarchie 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 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 auf eingabe. In der Ausgabe wird die Anzahl der Zeichen in der vollständigen Namenhierarchie angezeigt.
Rückgabewert
Diese Funktion gibt einen der folgenden Werte zurück.
| Wert | Bedeutung |
|---|---|
|
Die Puffergröße ist nicht ausreichend groß. Die richtige Größe wird in lpdwBufSize zurückgegeben. |
|
Der im hSession-Parameter angegebene Wert ist NULL oder ist ungültig. |
|
Die Medienpool-ID fehlt oder ist ungültig. |
|
Der Parameter fehlt oder ist ungültig. |
|
Fehler bei der Speicherzuweisung. |
|
Die Funktion war erfolgreich. |
Bemerkungen
Hinweis
Der ntmsapi.h-Header definiert GetNtmsMediaPoolName als Alias, der die ANSI- oder Unicode-Version dieser Funktion basierend auf der Definition der UNICODE-Präprozessorkonstanten automatisch auswählt. Das Mischen der Verwendung des Codierungsneutralen Alias mit Code, der nicht codierungsneutral ist, kann dazu führen, dass keine Übereinstimmungen auftreten, die zu Kompilierungs- oder Laufzeitfehlern führen. Weitere Informationen finden Sie unter Konventionen für Funktionsprototypen.
Anforderungen
| 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 |