CLAIMMEDIALABEL-Rückruffunktion (ntmsmli.h)
[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 |
|---|---|
|
Die MediaLabelInfo-Bibliothek, die in der MediaLabelInfo-Struktur ausgefüllt wurde. |
|
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 |