IMFSensorDevice::GetSymbolicLink-Methode (mfidl.h)
Ruft den symbolischen Linknamen des Sensorgeräts ab.
Syntax
HRESULT GetSymbolicLink(
[out] LPWSTR SymbolicLink,
[in] LONG cchSymbolicLink,
[out] LONG *pcchWritten
);
Parameter
[out] SymbolicLink
Puffer von cchSymbolicLink-Zeichen , in denen der symbolische Linkname geschrieben wird. Der Puffer muss groß genug sein, um den NULL-Abschlussator zu berücksichtigen.
[in] cchSymbolicLink
Anzahl der im SymbolicLink-Puffer verfügbaren Zeichen.
[out] pcchWritten
Ausgabeparameter, der die Anzahl der zeichen enthält, die in SymbolicLink geschrieben wurden. Dies schließt den NULL-Abschlussator ein. Wenn SymbolicLink NULL und cchSymbolicLink 0 ist, enthält pcchWritten die Anzahl von Zeichen, die zum Speichern des symbolischen Linknamens erforderlich sind (einschließlich des NULL-Abschlussators).
Rückgabewert
Die Methode gibt ein HRESULT zurück. Mögliches Werte (aber nicht die Einzigen) sind die in der folgenden Tabelle.
| Rückgabecode | BESCHREIBUNG |
|---|---|
|
Die Methode wurde erfolgreich ausgeführt. |
|
Der im SymbolicLink-Parameter bereitgestellte Puffer ist nicht groß genug, um den symbolischen Linknamen zu enthalten, einschließlich des NULL-Abschlusszeichens. |
|
Das Sensorgerät wurde nicht initialisiert. |
Hinweise
Je nach Gerätetyp, der durch ein Element der MFSensorDeviceType-Enumeration definiert wird und durch Aufrufen von GetDeviceType abgerufen werden kann, kann der resultierende symbolische Name ein gültiger symbolischer Gerätename oder eine Anbieter-URL sein. Der Aufrufer sollte nicht versuchen, den Namen zu analysieren, und sollte ihn als undurchsichtige Daten behandeln.
Anforderungen
| Unterstützte Mindestversion (Client) | Windows 10, Version 1607 [nur Desktop-Apps] |
| Unterstützte Mindestversion (Server) | Nicht unterstützt |
| Zielplattform | Windows |
| Kopfzeile | mfidl.h |
| Bibliothek | Mfplat.lib; Mfplat.dll |