CLAIMMEDIALABEL-Rückruffunktion (ntmsmli.h)

  • Artikel

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

Die ClaimMediaLabel-Rückruffunktion bestimmt, ob eine angegebene Medienbezeichnung von der zugeordneten Anwendung des Mediums erstellt wurde.

Syntax

CLAIMMEDIALABEL Claimmedialabel;

DWORD Claimmedialabel(
  [in]  const BYTE * const pBuffer,
  [in]  const DWORD nBufferSize,
  [out] MediaLabelInfo * const pLabelInfo
)
{...}

Parameter

[in] pBuffer

Zeiger auf einen Puffer, der die Medienbezeichnung enthält.

[in] nBufferSize

Größe des Puffers in Bytes.

[out] pLabelInfo

Zeiger auf eine MediaLabelInfo-Struktur . Die Medienbezeichnungsbibliothek füllt diese Struktur aus, wenn die Bibliothek die Medienbezeichnung erkennt.

Rückgabewert

Diese Funktion gibt einen der folgenden Werte zurück.

Wert Bedeutung
NO_ERROR
 Die MediaLabelInfo-Bibliothek, die in der MediaLabelInfo-Struktur ausgefüllt wurde.
ERROR_BAD_FORMAT
 Die Medienbezeichnungsbibliothek erkennt die Medienbezeichnung nicht.

Hinweise

Wenn eine Medienbezeichnungsbibliothek die ClaimMediaLabel-Funktion verwendet, um die Medienbezeichnung als von der zugehörigen Anwendung erstellte Bezeichnung zu identifizieren, muss die Medienbezeichnungsbibliothek die MediaLabelInfo-Struktur ausfüllen und NO_ERROR zurückgeben. Wenn die Medienbezeichnungsbibliothek die Medienbezeichnung nicht erkennt, gibt sie ERROR_BAD_FORMAT zurück.

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 ntmsmli.h

Weitere Informationen

Medienbezeichnungsbibliotheksfunktionen

MediaLabelInfo